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NIDAS DESIGN DOCUMENT, 
DATABASE SPECIFICATIONS, AND DATABASE 
ADMINISTRATION 


1.0 INTRODUCTION 

1.1 Scope 

1.1.1 Identification 

Computer Software Configuration Item (CSCI): Naval Interactive Data 
Analysis System (NIDAS) 

Version: 3.1 

Release Data: To be determined at a later date 

NASA NAS13-564-D0-82 
NASA NAS13-564-D0-96 

J.H. Corbin, Director 
Mississippi State University 
Center for Air Sea Technology 
Building 1 103, Room 233 
Stennis Space Center, MS 39529-6000 
Telephone: (601.) 688-2561 
Facsimile: (601) 688-71.00 

Clifton Abbott 
Mississippi State University 
Center for Air Sea Technology 
Building 1 103, Room 233 
Stennis Space Center, MS 39529*6000 
Telephone: (601.) 688-3085 
Facsimile: (601) 688-7100 


The objective of NIDAS is to provide NAVOCEANO with an interactive 
overlay capability for several types of oceanographic, meteorological, and 
satellite defined data, and create 3-D gridded fields of temperature and salinity 


Contract No: 
Contractor: 


Principal Investigator: 


profiles constructed from a combination of "provinced" data (user derived) and 
gridded data. 

Under this project, the tasks were to ingest static databases into a CAST 
installed EMPRESS/NEONS system; prepare draft, and final design/database 
specification documents; ingest revolving databases into EMPRESS/NEONS; 
design and develop additional application programs to provide the capability to 
interactively view and evaluate the OTIS fields by comparison with other data 
fields; assist NAVOCEANO in interfacing the system to the classified POPS via 
the LAN to ensure the continuity of NIDAS operational commitments; train 
NAVOCEANO personnel in NIDAS system operation; and provide informal 
monthly demonstrations on NIDAS. This was completed in 1994 as NIDAS 
Version 1.0. From this version, NIDAS for climatologies was performed in 
1995 with documentation as NIDAS-C Version 2.0 completed in 1996. 

In FY96, CAST also provided maintenance and development tasks for 
NIDAS at both the unclassified and classified levels, and was also funded by 
NAVOCEANO to develop software upgrades to NIDAS that will enable 
NAVOCEANO to better produce databases and products specific to Mine 
Warfare. NAVOCEANO also provided funding to port NIDAS from EMPRESS 
to ORACLE. The result of this upgrade is NIDAS Version 3.1. 

1.1.3 Document Overview 

The purpose of this document is to define and describe the structural 
framework and logical design of the software components/units which will be 
integrated into the major computer software configuration item (CSCI) 
identified as NIDAS Version 3.1. The preliminary design is based on functional 
specifications and requirements identified through contracts specified above. The | 

contents and format of this document are specified by Department of Defense j 

(DOD)-STD 2 167 A. Function names appear in bold and ends with empty 
parentheses. 

Appendix A contains a glossary of terms used. Appendix B is a listing of 
acronyms. The NIDAS relational database specification is contained in 
Appendix C. Appendix D contains functional and design requirements for the 
NIDAS relational database management system (RDBMS). Refer to Appendix E 
for a description of the NIDAS development environment. Appendix F contains 
a listing of all relevant source code structures. Appendix G provides a default 
configuration file. Appendix H provides for the NIDAS Region Configuration 
System, and Appendix 1 provides Database Administrator Tools. 
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1.2 Referenced Documents 


Note: The section(s) or subsection(s) of this, document wherein a reference 
is cited appears as parenthetical information following each document listed. 

1 .2. 1 DOD-STD 21 67 A “Defense System Software Development”, AMSC 
No. N4327, 29 Feb 88. (1.3) 

1.2.2 NASA NAS12-564 Delivery Order 82 dated 23 May 1996. 

1.2.3 NASA NAS 12-5 64 Delivery Order 96 dated 4 September 1996. 

2.0 PRELIMINARY DESIGN 



The Naval Interactive Data Analysis System (NIDAS), a stand-alone system, 
is the major Computer Software Configuration Item (CSCI) developed by this 
project Functional requirements, as identified by the sponsor, were not defined 
in the context of a modular approach to software development. Therefore, the 
subordinate tasks necessary to fulfill these requirements have been divided 
among/assigned to the internal Computer Software Components (CSC) for 
accomplishment. The top-level (simplistic) NIDAS architecture is illustrated in 
Figure 1. 

There are four principle CSC's within the NIDAS structure: 

• Graphical User Interface 1 (GUI 1) - incorporates window manage- 
ment, user interface and display functionality; 

• Graphical User Interface 2 (GUI 2) - incorporates window manage- 
ment, user interface and display functionality; 

• Data Retrieval Module (DRM) - provides functional data manage- 
ment using relational RDBMS technology; 

• Data Interactive Module (DIM) - incorporates data processing, appli- 
cation of interactive methods and algorithms to the data, and graphical 
(visualization) processing of the data; 

NIDAS has one external interface, the User-GUI interface which includes 
two graphical user interfaces. The User-GUI interface supports 1) user control 
of interactive techniques and 2) response/feedback to the user in the form of data 
display (graphical or numerical) and status indicators. 
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2.1.1 CSCI Architecture 

Figure 1 illustrates the NIDAS Top Level module and external interface 
architecture. There are four CSC’s. 


CSCI: NIDAS 

I — 



Figure 1. Top-Level Modular Structure of the Naval Interactive 
Data Analysis System (NIDAS). 


2.1. 1.1 CSC.1 

Graphical User Interface 1 (GUI 1). The NIDAS top level GUI 
supports and manages Che links between the user and NIDAS. Through the GUI, 
the user exercises all available NIDAS control options. NIDAS provides displays 
to the user for interpretation and interactive response. The GUI integrates non- 
developmental software as follows: 

• X-WIndows (proprietary): Manages all controls and display windows. 
The X-Windows clients/server model supports remote user access to 
NIDAS using network protocol via the UNIX operating system. 

• Motif Widget Toolkit (proprietary): Provides a widely accepted 
standard inventory of window components (Widgets) pleasing to the eye 
and easy to interpret. 

Functionally of the GUI allows the user to select a project area. 
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2.1. 1.2 CSC 2 



K 
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Graphical User Interface 2 (GUI 2). The NIDAS GUI for the main 
window display integrates the same non-developmental software (X-Windows & 
Motif Widget Toolkit) as GUI 1. In addition it serves as the agent for internal 
DRM/DIM communications. 

Functionally of.the GUI is to exercise direct, centralized control over the 
DRM and DIM;~monitor activities of the DRM and DIM via their external 
interfaces; intercept, interpret and route user interactive commands; provides 
status information and feedback to the user; provide a windowing environment 
for visualization of data, display of control elements, and intercepting user 
interactive commands; and receive and interpret user input via the keyboard or 
mouse pointing device. 

2.1. 1.3 £S 02 

Data Retrieval Module (DRM). The NIDAS DRM is tasked with 
managing access to and communications with the internal RDBMS. In addition, 
the DRM prepares simple data displays that conform to user-selectable options 
and passes them to the GUI for presentation in a window. When a data display is 
designated for interactive manipulation, it is passed to the DIM via the GUI. The 
DRM receives data management: instructions from the GUI (user). In turn, 
through the Naval Environmental Operational Nowcast system (NEONS), the 
DRM translates these instructions into Structured Query Language (SQL) 
commands to the RDBMS. The DRM is also responsible for allocating the 
internal memory space for data retrieved from the database or data destined for 
database ingestion. The DRM employs the following non-developmental software 
in accomplishing its tasks: 

• UNIRAS ag/X Toolraaster (proprietary): Handles graphical 
representation and visualization of data displays; 

• Oracle RDBMS (proprietary): Performs low-level management of the 
RDBMS; 

« Naval Environmental Operational Nowcast System (NEONS) 
(government provided software): Performs h»gh level management of the 
RDBMS via embedded SQL commands to the underlying Empress 
RDBMS. NEONS also embodies the data model used by the RDBMS. 
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2.1. 1.4 CSC 4 


Data Interactive Module (DIM). The DIM modifies and manipulates 
the data in response to user interactive commands. It supplies the main window 
GUI with real-time, updated data displays that reflect user interaction. As in the 
DRM, graphical representation and visualization with the DIM is accomplished 
using UNIRAS ag/X Toolmaster (proprietary non -developmental software). 

2 . 1.2 System States amlMcdga 

NIDAS is an interactive software application and is always in the event- 
driven state. As with all event-driven software applications, NIDAS may assume 
either of two execution states (modes): processing and rest (idle). The NIDAS 
default state is the rest mode. When not processing data in response to user input, 
NIDAS automatically reverts to the rest mode and awaits the next user command 
or input. 

2.1.3 Time Macalisn 

The interactive, event-driven nature of NIDAS precludes a quantitative 
description of memory allocation and processing time among NIDAS CSC’s. 
Thus NIDAS responds to user demands by allocating memory, swap space, and 
processor time within the limitations imposed by available memory and UNIX 
operating system constraints. 

2.2 c$CE Design Description 

The CSCI (NIDAS) consists of four CSC modules with functionality as 
described above. The remainder of this section identifies NIDAS requirements by 
CSC and discusses the software design employed to achieve the required 
functionality. The CSCI incorporates all NIDAS functional requirements (NFR) 
and design requirements (NDR) as presented in Section 5. The CSCI achieves the 
following design requirements: NDR1, NDR2, NDR3, and NDR4. 


CSC 1 is responsible for providing the visual display link between the user 
and the NIDAS top level interactive display. The preliminary design for the 
NIDAS top level interactive display window is illustrated in Figure 2. While 
other CSC modules manage their own suite of window displays, the GUI is the 
ultimate destination of the functionality achieved through user interaction with 
them. The GUI and its sub-level components achieve the following specific 
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functional and design requirements, either wholly or in concert with other CSC’s 
(see Section 5): NFR1, NFR9, and NFR10. 



Figure 2. Illustration of the NIDAS Top Level GUI 1 (CSC1) Display Screen. 
2.2.2 GUI 2 (C SC 21 

CSC 2 provides the visual display link between the user and the NIDAS 
main window interactive display. The preliminary design for the NIDAS main 
window interactive display window is illustrated in Figure 3. The GUI and its 
sub-level components achieve the following specific functional and design 
requirements, either wholly or in concert with other CSC’s (see Section 5): 
NFR1, NFR2, NFR12, NFR 1 3, NFR14, NFR15, NFR16, NFRI7, NFR18, 
NFR19, and NFR21 . 
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Figure 3. illustration of the NIDAS Main Window GUI 2 
(CSC 2) Display Screen. 


2.2.3 



CSC 3 controls the selection and display of data for NIDAS CSCI. User 
interaction with the DRM is handled via the Data Selection pop-up window shown 
in Figure 4a. There are three choices for each selectable data type listed in the 
“Data Selection” pop-up window: "Data”, “Options”, and ‘‘Dismiss”. The “Data” 
button produces dialog pop-up windows, tailored to each data type that allow 
selection of available parameters contained in the dataset. The “Options” button 
produces data dialog pop-up windows tailored to each data type, offering other 
user options such as color. The “Dismiss” button removes the “Data Selection” 
pop-up window. Once data has been read into memory, a toggle button is 
produced for that data type in the “Display Toggle Buttons” area, shown in 
Figure 4b. The toggle button specifies the data to view in the "Main Chan” and 
in the "Profile Chart". The DRM and its sub-level components achieve the 
following specific functional and design requirements, either wholly or in concert 
with other CSC’s: NFR1, NFR3, NFR4, NFR5, NF-R6. NFR7, NFR8. NFR11, 
NFR1.3, NFR20, NDR5, and NDR6. 
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(a) Data Selection (b) Display Toggles 

Figure 4. Illustration of the DRM. 



CSC 4 provides capability for manipulating and editing selected data. 
Options are provided to support identification of data subsets by constructing 
polygon boundaries, zooming of data profiles for improved interpretation/ 
analysis, interpolating the data, displaying vertical cross sections of volume data, 
displaying an image histogram, display point information for an image, 
synthetically creating profiles, and grid-editing Volume-LLT data. The DIM and 
its sub-level components achieve the following specific functional and design 
requirements, either wholly or in concert with other CSC’s: NFR1, NFR11, 
NFR14, NFR16, NFR18, NFR21 , and NDR8. 

3.0 DETAILED DESIGN 


Figure 5 illustrates the functional connectivity within NIDAS and forms the 
basis for the detailed design of the NIDAS CSCI. The preliminary design (see 
section 3) provides a broad overview of the framework and functional design of 
the NIDAS CSCI and its four CSCs (GUI1, GUI2, DRM, and DIM). In this 
section, each CSC is described. 



The design criteria for the Top Level GUI and the Main Window GUI are 
listed in Section 5, “Requirements Traceability”. These CSIJs are constrained by 
the following: 1) the X-server must be opened and available for display; 2) the 
database must be opened and available for reading; and 3) UNIRAS ag/X 
Tool master must be active for handling graphics functionality. 
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Figure 5. NIDAS Detail Design and Connecting. 

3 . 1.1 C^U-IhsiiliMS-Tgp U vel Wind ow ( flULD 

3.1. 1.1 Components 

Figure 2 illustrates the layout for the Top Level GUI. The main components 
of the front page CSU are: globe map, project area specification, menu bar, and 
title area. 


3.1. 1.2 Functionality 

The Top Level Window GUI design employs the X, Motif, and UNIRAS 
ag/X Toolmaster libraries. Input to the GUI is via the REGION_INFO data 
structure. The function getFrontPageColorsO gets the pixel value of specified 
colors. The function mapPageLayoutO creates the layout for the top level 
window. Within this function, nidasMainPulldown() creates the menujiar. 
CreateMapFormO creates the globe map and its components. The function 
getRegLfstO retrieves a list of predefined project areas and puts them in the 
region list. The function regionSelectO is called when a selection is made on 
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the region list and the appropriate functions are called from within to draw the 
rectangle across the selected region in the globe. Latlon2Cursor(), 
Cursor2LatLon(), and ZoomCursoriLatlonO are associated with transform- 
ing values between the xy coordinates of the cursor and the latitude/longitude 
values and vice versa. Latlon2Map() is called to transform the latitude/ 
longitude values into a rectangle across the region in the globe. 

SelectZoomO is called when the “Zoom” button, is selected. This calls the 
required functions to draw a zoomed version of the selected region. 
ZoomDatadialogO.DrawZoomMapO, and ZoomCursor2Latlon() are 
involved in this process. 

The function nidasPopUpO is called when the “Nidas” button is selected 
from the “Program” pulldown menu in the menu bar. This allocates the required 
memory for the data structures, sets the appropriate display values, and calls 
nidasGraphicsInterfaceO to display the Nidas Main Window. 

3.1.2 CSC 2 - The NID AS.M ain Window (OULfl 

3. 1 . 2.1 Campflaenls 

Figure 5 illustrates the functional connectivity within NIDAS. The design of 
the Main Window is subdivided into the following: the Title Area; the “Main 
Chart” which provides a geographical display; the “Profile Chart” which displays 
the profiles of the LLT data type; a pull-down menu bar containing various 
options for interacting with the “Main Chart” and “Profile Chart” windows; data 
control and interaction buttons; window control buttons; and a “Remark” area 
which communicates important messages to the user. 

3. 1.2.2 Functionality 

Like the top level page design, the NIDAS main window page design 
employs the X, Motif, and UN1RAS ag/X Tool master libraries. The NIDAS 
data structure is used to store and retrieve any input data pertaining to the NIDAS 
main window. The function readDefaultValues() is called to read default 
values into the I)EFAULT_STRUCT data structure from a specified file. The 
function getColorPixelO initialize the colorStruct data structure. The function 
allocMenioryAndInit() allocates memory to the NIDAS structure and initialize 
the data elements. The function createLogLayoutO creates a scrolled text area 
to log user interactions with the application. The function mainWindowData 
Dialog!) converts the lat/lon data into the mercator projection and also stores 
the min and max window coordinates in the NIDAS data structure. It also stores 
the bathymetry values and finds its min and max values. 
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The function frontPageLayoutO creates the layout of the NIDAS main 
window as shown in Figure 3. The various data action and analysis buttons are 
created here as are the window control buttons. The function nidasPulldownO 
creates the menu bar. A second menu bar is created which contains the various 
data action and analysis buttons. The function dataFerm() is called to create the 
NIDAS Data Interface Module. It then creates the data selection dialog but does 
not display it. The data form calls getRegDataTypeO to retrieve all the data 
types and the corresponding data models available. Then the “Main Chart” and 
the “Profile Chart” drawing areas are created. The “Nidas” button when selected, 
displays a list of options and an “Exit” button. The “Help” button has a list of 
options provided to offer help. 

3.1. 2.3 Nidas PulldownJvleim 

The “BackG/ForeG Color” option from the “Nidas” pulldown menu calls 
InvertBackGForeGColorO to invert the background and foreground colors 
of the display. The “Window/Pixmap First” option calls selectDrawOrderQ to 
set the drawing order. The drawing order specifies whether the graphics are 
drawn in the chart windows and then stored in memory, or drawn in memory 
first and then in the chart windows. The “Label” option calls displayLabelO to 
display the labels. When the “Status” button is selected, display Status() is called 
which creates and displays a scrollable status dialog. The dialog lists all the 
default values for the various data types. When the “Log” button is selected, 
ShowLogDisplayO is called which creates and displays a scrollable log of the 
user's actions. 

3.1. 2.4 Help 

The buttons “Layout”, “Data Selection”, and “Data Analysis” from the 
“Help” pulldown menu calls createlnterfaceHelpO to provide on-line help in 
the respective topics. 

3.2 

3.2.1 Components 

Figure 4 illustrates the components of the NIDAS Data Interface. The 
purpose of the interface is to provide data retrieval, display, and manipulation 
options for the following data: Bathymetry, Coastline, LLT, Volume, and Image. 
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3.2.2 Functionality 


When the “Data Select/Option” button is selected, dataPressO is called to 
manage and display the data dialog as shown in Figure 4. The data selection 
component consists of two main components: Data and Options for the 

Bathymetry, Coastline, LLT, Volume, and Image. Selecting a particular data 
type from the “DATA TYPE” list in the data dialog executes typeBrwsQ which 
registers the data type selected and lists all the datasets available for the selected 
data type. Selecting a particular dataset executes dataBrws() to register the 
selected data set. When the “Data” button is selected, dataSelectPress() is 
called which retrieves the data for the selected data model. When the “Options” 
button is selected, optionChoicePressO is called which displays the options 
dialog for the particular data type. Depending on the particular data type 
selected, the corresponding functions are called to perform the data retrieval or 
displaying the options dialog as explained below. 

3.2.2. 1 Bathymetry 

3.2.2. 1.1 Data Selection 

When Bathymetry data is selected, readBathymetry() is called to retrieve 
the data from the database in accordance with the parameters contained in the 
region selected. The required memory is allocated and the retrieved data is then 
stored in the NIDAS Bathy structure. After the data has been, retrieved, a toggle 
button for that dataset is created in the “Display Toggle Buttons” area. This 
toggle button allows the turning on and off of the dataset. 

3.2.2. 1.2 Data Display 

When the display toggle button for a bathymetry dataset is selected, 
displayBathynxetryO is called to perform the rendering of the bathymetry. 
The function createlsoliinesO is called to render the isolines. This function first 
checks the option values for errors, allocates the required memory, and performs 
the rendering. The function copyPixmapO allocates the required amount of 
memory for the pixmap and then extracts the bathymetry data from the original 
bathymetry array for the region. After creating the pixmap, this function then 
releases the memory allocated! for the new array. 

3.2.2. 1.3 Data Options 

When the “Options” button for a specific bathymetry dataset is selected, 
bathyVolImageOptionsO is called. This function creates and displays the 
“Bathymetry Options” pop-up window as shown in Figure 6. This pop-up dialog 
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allows for the setting of the minimum, maximum, contour internal, color value, 
label on/off, isoline width, and label height. When the “Reset” button is selected, 
resetOptionsO is called to restore the original values from the BATHYMETRY 
data structure. 



Figure 6. DRM “Options” Pop-Up for Bathymetry Data 
3.2.2.2 Coastline 

3.2.2.2.1 Coastline-D ata Selection 

When the Coastline data is selected, coastLineLayout() is executed. This 
function creates and displays the “Coastline Data” pop-up window which provides 
the selection between four kinds of coastline. When one of the types of coastline 
is selected from the Coastline pull down menu, the correct coastline name is 
displayed in the text area. 

3.2.2.2.2 Data Display 

By default, the display toggle button for the Coastline is selected. Selecting 
this button calls displayCoastLineO which calls createCoastllnePixmapO. 
This sets the appropriate scale values with regards to the “Main Chart” area of the 
main window and then calls draw_coast() to allocate the required memory and 
draw the coastline. The GEOG routines are used to perform the retrieval of the 
coastline data from the database and draw the coastline. Deselecting the Coastline 
display toggle button executes drawMainwlndowGraphicsO, which calls 
dlsplayCoastlineO to remove the coastline from the pixmap. 
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32.2.2.3 Data Options 


Selecting the “Options” button for the Coastline executes 
coastLineLayout(). Like the Coastline “Data” selection, this function creates 
and displays a pop-up dialog. This dialog allows for selecting the coastline color. 

32.2.3 LLT 

3.2.2.3.1 Data Selection 

When “Data” is selected for a specific LLT dataset, createLltData 
layout () is executed. This creates and displays a data selection window for the 
LLT data type as shown in Figure 7. This dialog allows for specifying the 
minimum and maximum values for the latitude, longitude, time, classification, 
month, parameters, cruise id, instrument type, source code, and water depth. 
The function createVrsnDialogO is called to create a dialog listing the versions 
available. This pop up dialog is made visible when showVrsnDialogO is 
executed by selecting the “Version” toggle button. The function getLltnVrsn 
Info() performs the actual retrieval of the versions from the database. Initially 
the default values from the NIDAS LLT structure are set for the various 
elements. These values can be changed to any appropriate value. Whenever a 
value is changed the corresponding function is called to register the new value. 

To initiate the retrieval of data the “Read” button is selected. This results in 
readLltDataO being called. The necessary header information is obtained, the 
input parameter values are validated, and the data is retrieved from the database 
by calling retrieveLltData(). The retrieveLltDataO function utilizes the 
LLTN database library routines to extract the data from the database. The 
function storeLltValsQ is called to allocate memory and store the data in the 
NIDAS LLT structure. When the “Reset” button is selected resetLltDataQ is 
executed to restore the original values from the LLT data structure. 

3.22.32 Data Display 

Selecting the display toggle button for the LLT dataset activates 
displayLlt(). Depending on whether the location and/or the profile buttons have 
been selected, createLltLocationPixmapO is called to create the profile 
locations pixmap and copy it onto to the main window “Main Chart” display. The 
function createLltProfilesPixmapO creates the profiles pixmap and copies it 
onto the “Profile Chart” display of the main window. When the display toggle 
button is deactivated, the LLT dataset profiles and the locations are removed 
from the “Profile Chart” and “Main Chart” respectively. 
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Figure 7. DRM “Data” Pop-Up for LLT Data 

Internally, createLltLocationPixmapO calculates all the boundary 
values, validates the data and performs the actual plotting of the locations by 
calling plotLltLatLon(). Likewise createLltProfilesPixmapO sets the 
proper scale, validates the parameters and calls drawLltProfile(). This 
calculates all the boundary values, validates the data and calls one of the 
two functions to draw the actual profiles: drawLltZoomedProfilesO if only 
the zoomed profiles are to be drawn, and drawLUAUProfilesO if all the 
profiles are to be drawn. 


Selecting the “Options” button for a specific LLT dataset executes 
crealeLltOptionsO, This creates a pop-up window, as shown in Figure 8, 
where by the various data parameters for the LLT data type can be set to the 
desired values. Among the various parameters that can be set is the option for 
indicating the profile flag settings. The corresponding functions are executed to 
register the new values. When the “Reset” button is selected resetOptionsO is 
called to restore the original values from the LLT data structure. 
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Figure 8. DRM “Options” Pop-Up for LLT Data 


3.2.2A Vfilmnfi 


When “Data” is selected for a specified volume dataset, setupVolDataO is 
executed. This function checks if the dataset is of the Climatology type or not by 
executing getVolTimeType(). The function volumeLayoutO is called to 
create and display the Volume data selection dialog as shown in Figure 9. The 
function getVolumelnfoQ is called from here to retrieve information about the 



Figure 9. DRM “Data” Pop-Up for Volume Data 
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various versions and list them. When a particular version is selected brwVrsn() 
is called to register the selection. When the “Read” button is selected to initiate 
the retrieval of the data, readVolumeDataO is called. This function frees any 
memory which has been previously allocated. The function getVolume() which 
is subsequently called, allocates the required memory and performs the data 
retrieval and stores the retrieved data. When the “Reset” button is selected, 
resetVolumeDataO is called to reset the VOLUME data structure. 

3.2.2.4.2 Data Display 

When the display toggle button is selected for the Volume dataset, 
volumeDlsplayO is called. This performs some parameter error checks and 
then calls updateVolLocationO to update the volume lat/lon data points if 
necessary. The function create VolLocation PixmapO is called to create a 
pixmap of the volume locations and then calls copyPixmapO to copy the 
pixmap onto the “Main Chart” area. If the “Profiles” option is selected then 
createVolProfllesPixmapO is called to create and draw the profiles in the 
“Profile Chart” area. When the display toggle button is deselected, 
drawMalnWIndowGraphlcsO and drawProfileWindowGraphicsO are 
called to render the graphics without the volume data. 

3.2.2.4.3 Bata.Qcii.flns 

Selecting the “Options” button for a specific volume dataset executes 
bathyVolImageOptions(). This creates and displays a pop-up window as 
shown in Figure 10. This pop-up dialog allows for the setting of the isoline, 
location, label, and profile on/off options as well as display levels, color values, 
minimum, maximum, interval, number of decimals, line widths, points size, and 
label heights. The function getVolLvl() retrieves and lists the various levels, 
while brwsLevelO is called to register any selected level. The corresponding 
functions are called to register any selected values. When the “Reset” button is 
selected resetOptlons() is called to restore the original values from the Volume 
data structure. 

3.2.2.5 Image 


When “Data” is selected for a specific Image dataset, ImageDataLayoutO 
is executed. The creates and displays the Image data selection dialog, as shown in 
Figure 1 1. The function getlmagcDateldO is called from within to retrieve a 
list of images and dates. When a particular image is selected getlmage() is 
called to register the image in the Image data structure. When the “Read” button 
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is selected, readlmageDataO is called to perform the retrieval of the image. 
When the “Reset” button is selected, resetlmageDataO is called to reset the 
IMAGE data structure of any image selected. 



Figure 10. DRM “Options” Pop-Up for Volume Data 



Figure 1 1. DRM “Data" Pop-Up 
for Image Data 











3.2.15.2 Pata Display 

When the display toggle button is selected for the Image dataset, 
displaylmageO is called. This first checks if any Image data is selected. Any 
existing image displayed will be freed from the pixmap and createNewImage() 
called. The window parameters are calculated and the required memory is 
allocated to the IMAGE data structure. The image values are calculated and a 
new Image pixmap is created. The function drawMainWlndowGraphlcsO is 
called to redraw the image in the “Main Chart” area and drawProfileWindow 
GraphicsO is called to redraw the profiles in the “Profile Chart” area. 

Selecting the “Options” button for a specific Image dataset executes 
bathyVoIImageOptions(). This creates and displays a pop-up window, as 
shown in Figure 12. This dialog allows for setting the minimum, maximum, and 
the interval values. When the “Grayscale” or the “ColorScale” toggle buttons are 
selected, colorTypeChanged() is called to register the selection in the IMAGE 
data structure. When the “Reset” button is selected resetOptionsQ is called to 
restore the default values to the Image data structure. 



Figure 12. DRM “Options” Pop-Up 
for Image Data 

3.3 CSC 4 - TheMDAS_D at a Interactiv^ Mi^ iklDlM ) 

3.3.1 Components 

The purpose of the DIM is to support user interaction with the data. The 
kinds of interactive options provided are: Changing of Parameters, Exporting, 
Zooming, Reference Polygon, Polygon, Polygon Subsetting, Polygon/Zoom 
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Options, Multiview, Interpolation, Flagging, Transect, Single Profile, Histogram, 
Point Information, Synthetic Profiles, and Gridding Session. There are also 
interactive window operations that can be used to manipulate the windows. Each 
of these options are described below. 

3.3.2 Functionality 

The DIM is programmed using the C programming language. It uses the X, 
Motif, NEONS, and UNIRAS ag/X Toolmaster libraries. 

3.3.2. 1 Parameters 

When the “Parameters” button is selected a menu of parameters is presented. 
Selecting a parameter will call selectParamO which will register the selected 
parameter. Depending on the parameter selected (Temperature, Salinity, Sound 
Speed, Density, or Conductivity), the Parameter selected vs Depth profiles are 
drawn in the “Profile Chart” area by calling drawProfileWindowGraphics() 
and the locations are drawn in the “Main Chart” area by calling 
drawMain WindowGraphicsO . 

3.3.2.2 Exporting 

I LT data may be expected via the “Data Tools” area on Profile Isolation 
(see Section 3.3.2.6). When the “Export” button is selected from the “Data 
Tools” area, a pulldown menu appears with four options: “Polygon Data” which 
exports only data that has been polygoned; “Accumulative Subset Data” which 
exports multiple subsets made in profile isolation (see Section 3.3.2.6); “All Data” 
which exports all data; and “Image Data” which exports images. When exporting 
through Profile Isolation, the export is treated like “Polygon Data”. When an 
option is selected, SetupExportDataQ is called. This function checks the 
conditions that it was called, initialize the EXPORT data structure by calling 
InitExportStruct(), and then creates and displays a pop-up dialog. The pop-up 
dialog allows the selection of data to export from (if more than one dataset is 
currently being displayed), the setting of a header and filename of each dataset, 
the selection of either binary format or ASCII format, and the selection of 
flagged profiles to export. When the “Export” button is activated, 
WriteToFileO checks the file format and exports the data according to the 
conditions given. 
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3.3.2.3 Zoom 

When the “Zoom” button is activated, zoomEdit() is executed. This 
function registers the required functions to the “Main Chart” area and unregisters 
them when the button is deactivated. 

The function zoomDrawingPress() is activated when the user clicks the 
left mouse button on the “Main Chart” area to start drawing a rectangle. The 
function zooml>rawingMotion() is activated when the user drags the mouse 
across a region in the “Main Chart” area, and zoomDrawingReleaseO is 
activated when the user releases the left mouse button to complete the drawing of 
the rectangle across the region to be zoomed. This computes the required lat/lon 
values and other parameters and calls zoomGraphics() which creates and plots 
all the graphics displayed in the zoomed area on the “Main Chart”. The function 
drawProflleWindowGraphicsO is called to create and plot all the profiles 
displayed in the zoomed area on the “Profile Chart”. 


3.3.2.4 



When the “Reference Polygon” button is selected from the “Analysis Tools” 
section dummyPolyEditO is called. This clears any previous reference poly- 
gons and prompts the user to draw the polygon. The function dummyPoly 
Press() is called when the polygon is being drawn. The left mouse button is 
utilized to indicate the current active chart. The middle mouse button is used to 
specify the location of polygon comers, and the right mouse button is used to 
close the polygon. The reference polygon is not active in the “Profile Chart” 
area. 

3.3.2.5 Polygon 

When the “Polygon” button is activated, polygonEdit() is executed. This 
function registers the eventhandlers mainPolyPress() to the “Main Chart” area, 
and profilePolyPressO to the “Profile Chart” area. When the “Polygon” 
button is deactivated, the eventhandlers are unregistered. 

The function mainPolyPressO utilizes the left mouse button to indicate the 
current active chart and it changes the border color of the “Main Chart” area. 
The middle mouse button is used to specify the locations of polygon comers. The 
right-most mouse button is used to close the polygon. Once the polygon is closed 
the proper scales are set by calling setMalnWindowScaleO and the polygon is 
drawn. Also, drawFlaggedLocations() is called to plot the locations of the 
data profiles lying inside the polygon in the “Main Chart" area and to plot the 
corresponding profiles in the “Profile Chart” area. 
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The function profilePolyPressO utilizes the left mouse button to indicate 
the current active chart and it changes the border color of the “Profile Chart” 
area. The middle mouse button is used to specify the locations of polygon 
comers. The right-most mouse button is used to close the polygon. Once the 
polygon is closed the proper scales are set by calling setProfileWindowScaleO 
and the polygon is drawn. Also, drawFIaggedProfilesO is called to plot the 
profiles lying inside the polygon in the “Profile Chart” area and their 
corresponding locations in the “Main Chart” area. 

3.3.2.6 Polygon Subsetting (Profile Isolation! 

When the “Profile Isolation” button is activated, profilelsolatePressO is 
executed. This function checks whether any of the displayed data have subsets and 
then calls createProfilelsolateOptionO to create and display a dialog to 
perform profile isolation. When any dataset toggle button is selected, display 
ProfileListO is called to display the profiles of the data type. Selecting the 
“Single” button from the “List Selection Policy” box selects one profile from the 
list. Selecting “Multiple” allows for more than one. Selecting “A11” selects all 
profiles from the list. Whenever a profile is selected, proflleListBrws() high- 
lights the selected profiles in the “Profile Chart” area and in the “Main Chart” 
area. 


The “Flag” button and the “Update DB” button are explained in detail in 
Section 3.3.2.10. 

The “Export” button function as described in Section 3.3.2.2 and treated as a 
polygon data export with the isolated profxle(s) as the polygoned data. 

When the “Delete” button is selected, deleteProfilelsolateO is called. 
This creates and displays an information pop-up dialog asking the user to 
reconfirm whether to delete or not. Selecting the “Ok” button activates 
okDeleteProfileO to delete the VOLUME, and/or LLT data from their 
respective data structures. After the profiles are deleted the allocated array 
memory is freed. The profiles tire deleted only from memory. 

Selecting the “Exit” button activates exitProfilelsolateO to destroy the 
“Profile Isolation” pop-up dialog, perform the necessary data structure updates, 
and exit. 

33 . 2.1 Polygon/ Zo o m Option^ 

Selecting the Polygon/Zoom Options button executes the function 
polyOptPress() which displays a pop-up dialog to facilitate setting of the 
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polygon options. Options such as vertex color, edge color, vertex size, edge line 
width, and vertex symbol can be specified. The functions getDotSizeO and 
getLineWldthO are called to register the values in the data structure. Selecting 
the “Zoomed Profiles only” toggle button will execute zoomProfilesO which 
sets the zoom only flag in the ZOOM data structure. Selecting the “Overlay 
Zoomed Profiles” will execute overlayProfilesO which will set the overlay 
flag in the ZOOM data structure. Selecting the “Dismiss” button calls 
exitPolyOpt() which exits and destroys the pop-up dialog. 

3.3.2.8 Mulimsa: 

When the “Multiview” button is selected from the LLT action buttons area, 
multi_view() is called. This calls checkValidMultiViewO to check for 
errors and allocate memory. Memory is allocated for the MainWindow data 
structure as well as for the ProfileWindow data structure to hold data for the new 
windows created. The newly allocated memory is initialized by calling 
InitMultiViewO. This populates the data structure with the required values and 
calls the functions to display the profiles in the different windows. The six 
windows that are created represent a reduced copy of the “Main Chart”, 
“Temperature vs Depth”, “Temperature vs Salinity”, “Salinity vs Depth”, 
“SoundSpeed vs Depth”, and “Density vs. Depth”. The function windowSetupO 
is called to perform setup operations (such as setting the label strings) on the six 
windows. Selecting “Multiview” again returns NIDAS back to a two window 
display. 

Only LLT data can be interpolated to a contour. When the “Interpolation” 
button is selected from the LLT action area, interPress() is called. The 
required memory is allocated for the CHARTER data structure and also a check 
is made to see if the LLT data is displayed. The charter bathymetry structure is 
initialized by calling ini(BathyStruct(). An “Interpolation Selection” dialog is 
then created that displays the different interpolation routines. The function 
getlnterMethodO is called when one of the interpolation routines is selected to 
register the selection. If more than one LLT dataset is available, then a list of 
those datasets are shown. When a particular dataset is selected, getlnterData 
Type() is called to register the selection. 

When the “Data” button is selected, InterApplyO is called. Thit initialize 
the EXPORT data structure and then creates and displays the “Charier Dialog” 
pop-up dialog as shown in Figure 13. This dialog allows for specifying the 
various Charter values such as grid interval (in minutes), latitude/longitude values 
for the lower left and upper right corners, depths, and smooth values, Selecting 
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the “Apply” button activates chrtrOkPressQ. This validates the specified data 
values, exports the data to a file with chrtrWriteToFileO, executes an inter- 
polation routine on this exported file in order to create the contour file, and 
imports the contour file back into memory. Etopo5 bathymetry is read from 
database functions to base the land masking on. This contour is treated as another 
datatype and is given a display toggle button for displaying. When the “Dismiss” 
button is selected, chrtrCancelPressO is called to destroy the dialog and to free 
the EXPORT data structure. When the “Help” button is selected, chrtrHelp 
PressO is called which creates and displays an on-line help dialog. 



Figure 13. DIM “Charter” Pop-Up Dialog 

When the “Options” button is selected, bathy VolImageOptionsO is called, 
whose functionality is as described in Section 3.2.2. 1.3. The land making option 
is added to this dialog for interpolation. 

3.3.2.10 Fla gging 

LLT profiles are flagged through the profile isolation dialog 
(Section 3.3.2.6). After one or more profiles have been isolated, the “Flag” 
button is selected where SetupFlagO creates and displays a pop-up dialog for 
setting flags. The function oreafeFlagToggleO is called to create ten differs 
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flag toggles: Not Yet Examined, Good Profile, Coarse Resolution, Inconsistent, 
Duplicate (but keeps), Duplicate (delete), Suspect, Needs Repair, Wrong 
Location, and Bad Profile. When one of these flag toggles are set, 
setPoofFlagO is called to set the profile flags. The required memory is 
allocated and the flag values are assigned to the FLAG data structures. When the 
“Reset” button is selected, setFlagResetO is called to reset the flag values. 

There are two ways to update the database of the flag changes: the “Update 
DB” button from the profile isolation dialog, or the “Update Flags” button from 
the “LLT Tools” area. Updating from the profile isolation dialog updates the 
database with one flag grouping at a time. This is a “flag-update, flag-update 
process.” Updating from the “LLT Tools” area updates the database of all 
accumulative profile isolation flagging. This is a “profile isolate-flag, profile 
isolate-flag, update process.” 

When the “Update DB” button from profile isolation is selected, 
updateProfilelsolateO is called. This updates the current flags in the database 
by calling updateDB(). 

When the “Update Flags” button from the “LLT Tools” area is selected, 
SetUpdateO is called. This checks for the display of LLT data and whether or 
not profiles have been flagged. The “Update Database Facility” dialog is then 
created and displayed. A list of datasets are displayed along with a toggle button 
to set on/off. When a toggle button and the “Update” button are selected, 
UpdateDBQ is called to update the database for each dataset selected. When the 
“Dismiss” button is selected, exitUpdate() is called which frees any allocated 
memory and destroys the dialog. 

3.3.2.11 IrJllSSg 

When the “Transect” button is selected from the Volume action area, 
transectEdft() is called. This checks for the presence of data and then calls 
transectDrawingPressO to calculate the end points and draw the transect. The 
middle mouse button is used to select the end points and the right button is used to 
start the transect. The function createTransectOptions() is called to create 
and display the options dialog for the transect as seen in Figure 14. After specify- 
ing the various options and when the “Apply” button is selected, applyTransect 
DlalogO is called. This checks whether a dataset has been selected and if it has 
been displayed. The required memory is allocated for the VERT_XSEC (TRAN- 
SECT) data structure. The required data for the data type selected is obtained 
from the VOLUME data structure. After the data values have been extracted, 
createTransedWindowO is called to create a window to draw transect isolines 
and profiles. The right mouse button is used to close the transect window. 
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Figure 14. Dim Transect Pop-Up Dialog 


3.3.2.12 Single Profile 

When the '‘Single Profile” button is selected from the Volume action area, 
singleVolEdltO is called. The function checks if a polygon is drawn. The 
function main VolLocGetPr ess () is called when the middle mouse button is 
clicked inside the drawn polygon. After setting the scale and getting the location 
value of the point selected, draw Single VolLocatlonO is called. This function 
sets the required scale, allocates the required memory, and draws the single 
profile on the “Profile Chart” area based on the location of the clicked point. 

3.3.2.13 Histogram 

When the “Histogram” button is selected from the Image action area, 
imageHistPress() is called. This checks if an Image has been displayed and 
then calls createlmageHistOptionO to create and display the “Image 
Histogram” dialog. If there are more than one image being displayed, this dialog 
allows the selection of a specific image. When an image has been selected, or if 
there is only image, setupImageHistogram() is called. This function provides 
the setup for the histogram and calls createlmageHistogramO to draw the 
histogram in the drawing area of the dialog. When the “Dismiss” button is 
selected, exitlmageHistogramO is called to destroy the dialog, reset the 
histogram flag, and exit. 
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3.3.2.14 Point Info 


When the “Point Info” button is selected from the Image action area, 
imagePtEditO is called. This checks if an Image has been displayed. When the 
middle button is pressed on a point in the image, imagePtDrawingPress() is 
called. This displays a dialog showing the. latitude, longitude, pixel value, and 
temperature of the selected image point. The dialog is updated each time the 
middle button is selected. The “Dismiss” button exits from this dialog. 

3.3.2.15 Synth etic Profiles 

When the “Synthetic” button is selected syntheticPress() is called. This 
function sets the appropriate flag and calls checkValiidSynthetic(). The 
function syntheticPopupQ is called to create and display the “Synthetic Profiles 
Selection” pop-up dialog as shown in Figure 15. A province polygon can be 
drawn if the synthetic profiles are to be from a subset of the data. When 
“Province” is selected, synProvicePress() is executed. On the “Main Chart” 
area, the middle mouse button is used to select the comer points of the polygon 
and the right mouse button is used to close the polygon. A synthetic profile can 
be drawn for an average profile, minimum profile, maximum, profile, and 
six alternative profiles. When one of these profiles is selected, SynSelectTog 
PressO is called. On the “Profile Chart”, the left mouse button is used to create 
a new point in the profile. The right mouse button is used to quit and cancel 
created mode. 



Figure 15. DIM “Synthetic Profiles Selection” Pop-Up Dialog 

When the “Overlay” button is selected, overlaySynProf() is called. This 
calls repaintAUO to clear the windows of any excess polygons and profile lines. 
The function lastProvince() is called to draw the last drawn province in the 
“Main Chart" area, and drawSynProfO is called to draw the synthetic profiles 
in the "Profile Chart” area. 
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When the “Import” button is selected, importSynthetic() is called. This 
function checks if the synthetic_db directory exists and is readable. A dialog is 
created and displayed prompting the user to make a selection. When the “OK” 
button is selected readSynProf() is called. This performs some error checks 
and then reads the synthetic profile data from the file. The functions 
readSynFromFileO , readProvincePtsO, and readRecordO are involved in 
the reading of the data from the file. 

When the “Export” button is selected, exportSynthetic() is called. This 
function checks if the export directory exists and also if province or profiles 
exists. The “Synthetic Export” pop-up dialog is created and displayed. An option 
is provided to save the synthetic profile in the synthetic database directory. 
Options are provided to specify the export file name, latitude, longitude, year, 
month, day, hour, province number, and region codes values. When the “Export” 
button is selected, writeSyntheticO is called. The checks the validity of the 
options specified and then writes the data into the file. If the file exists, the user is 
prompted. If the “save in database directory” button is selected, okSaveSyn 
InDbaseO is called to copy the data into the directory. 

When the “ResetICLIM” button is selected, resetSynthetic() is called to 
reset the SYNTHETIC data structure for the profile type selection. 

When the “Dismiss” button is selected, exitSynthetic() is called to destroy 
the synthetic dialog, reset the flags, reset the various data structures, and exit. 

When the “Synthetic Profile Options” toggle button is selected, 
synOptTogPressQ is called. This function calls createSynOptDialogO to 
create and display the “Synthetic Profile Options” dialog. This dialog provides 
for the specifying of the First and Last Depth Values, Depth On/Off, Line Color, 
Line Width, and Line Style of the different types of profiles. 

3.3.2.16 fipdJdiiing 

When the “Sessions" pulldown in the “Gridding” section has been selected, 
three options appear: Read, Edit, and Store. When “Read” is selected, 
ReadSesslonO is called. This function calls getActiveLLTO to read and 
display the active LLT data that lias been converted from a volume. 

When the “Edit” button is selected, edltSession() is called to check for the 
presence of a polygon and then create a pop-up dialog, as shown in Figure 16. 
This dialog is the same dialog as the profile isolation dialog except instead of 
selecting a dataset, you select an “Editing Policy” anu an “Edit” button has been 
added. The rest of the functions in this dialog are described in Section 3. 3.2.6. 
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When the editing policy of “New Synthetic'* has been selected and the “Edit” 
button pressed, editProfilelsolateO is called. This function creates a line at 
the end depth on the “Profile Chart”. The left mouse button is used.to select a 
new point for a depth while the middle mouse button quits the new synthetic 
mode. 
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Figure 16. DIM Grid Edit Pop-Up Dialog 


When the editing policy “Partial Synthetic” has been selected and the edit 
button pressed, editProfilelsolateO is called. The left mouse button is used to 
select the start and end points on an existing profile. The middle mouse button 
registers the end points and starts the “New Synthetic’* mode for the selected 
range. The rip bt mouse button cancels and quits partial synthetic mode. 

When the “Store” button is selected, StoreSessionO is called. This 
function calls storeActiveLLTO to create a pop-up dialog asking “Store in 
Database”. When “OK” is pressed, okStoreActiveLLTO is called. This 
function deletes the current LLT and calls writeLLTO to ingest the new LLT 
into the database. 


3.3.2.17 



The window operations are applied to the current active window. The active 
window is indicated by a blue border around the window. Possible active 
windows are the “Main Chart” window, the “Profile Chart” window, or any one 
of the six multiview windows (See Section 3. 3, 2.8). 


30 



When the “Repaint” button is selected, repaintWindowQ is called. This 
function clears the highlighted window of all the user graphics leaving only the 
profiles or the locations. 

When the “Default” button is selected, returnDefault() is called. This 
function resets the values of the highlighted window to the values present before 
any changes were made by the user. The functions zoomGraphicsO and 
drawProflleWindowGraphicsO are utilized here. 


When the “Window Options” button is selected, axisTextOptions() is 
called to create a pop-up dialog for the “Main Chart” window as shown in 
Figure 17, or any of the profile windows as shown in Figure 18. This dialog 
allows the setting of some axies options, text options, marker options, and title 
options (profile window only). When the “Apply” button is selected, 
applyMainAxisPressQ is called to register the changes for the “Main Chart” 
window, while applyProfileAxisPres() is called for the profile window. 



Figure 17. DIM “Window Options” 
for Main Chart Window 
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Figure 18 . DIM “Window Options” 
for Profile Chart Window 


When the “Last Polygon” button is selected, lastPolygon() is called. This 
function calls repafntWlndow() first to clear the window of any polygons and 
other user graphics. Then depending on which window is selected, the last drawn 
polygon is drawn by obtaining the values from the BACKUP structure. 

When the “ErasePoiy” button is selected, erasePolygon() is called to erase 
any polygon from the window. 

When the “PlotEnhance” button is selected, plotEnhance ProcessO is 
called. Memory is first allocated to the PLOT_ENHANCEMENT data structure 
and it is initialized. The “Enhancement Dialog” is then created and displayed. 
Pixel width and pixel height can be set here. Selecting the “Apply” button 
executes applyEnhance(). This function checks for the validity of the pixel 
width and height and calls createEnhanceWindowQ to draw the enhancement 
plot. The function drawEnhancePlot() does the ac.ual plotting. When the 
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mouse button is clicked on the enhancement drawing window, exitEnhance 
Window() is called to exit the plot enhancement drawing area window. When 
the “Dismiss” button is selected, exitEnhance() is called to free the memory and 
exit from the “Enhancement Dialog”. 

When the “RepaintAll” button is selected, repaintAll() is called. Like 
repaintWindow(), this function also clears, from all visible windows, all the 
polygons and other user graphics. 

4.0 NIDAS DATA 

NIDAS retrieves data from the NIDAS database except for the user 
configuration file. The user configuration file is located in the NIDAS 
installation in a file named nidasConfig.def. There are no other data file 
requirements for NIDAS. The NIDAS database is described in Appendix C and 
the configuration file is described in Appendix G. 

5.0 REQUIREMENTS TRACEABILITY 

Functional requirements (NFR) and design requirements (NDR) have been 
defined for NIDAS. NFR/NDR requirements are also indicated in subsections 
for cross-reference and traceability. CSC responsibility for achieving each NFR 
and NDR are indicated parenthetically in the following descriptions for each NFR 
and NDR. 



NFR1: Operate in an interactive manner, i.e., displays must be 
interactive. (GUI1, GUI2, DRM, DIM) 

NFR2: Provide overlay capability for several different types of ocean, 
and meteorological data. (GUI2) 

NFR3: System must be able to manipulate overlays of various data types. 
(DRM) 

NFR4: Access to Regional Bathymetry. (DRM) 

NFR5: Access to Coastlines/Shorelines. (DRM) 

NFR6: Access to Regional LLT. (DRM) 

NFR7: Access to Regional VOLUME. (DRM) 

NF.R8: Access to Regional IMAGE. (DRM) 

NFR9: Top Level GUI must display the global coastline, and a list of 
selectable regions. (GUI1) 

NFR10: Top Level GUI must have zoom capability. (GUI1) 

NFR1 1: Selectively evaluate and/or edit environmental data. (DRM/DIM) 
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NFR12: Selectively retain subsets of environmental data after evaluation 
and/or editing procedures have been performed. (GUI2) 

NFR13: Main Chart must display data distribution points (profile 
locations), contoured data fields, coastlines, bathymetry contours, 
and images (satellite data). (DRM/GUI2) 

NFR14: Main Chart must support construction and overlay of polygons. 
(DIM/GUI2) 

NFR15r Profiles on Main Chart must be viewable on envelope or inside 
envelope. (GUI2) 

NFR16: Main Chart and Profile Composite Chart must have zoom 
capability. (DIM/GUI2) 

NFR17: Toggle between temp, sal, sound spd, density, and conductivity in 
Profile Composite Chart. (GUI2) 

NFR18: Create synthetic temp or sal profiles in Profile Chart. (DIM/ 
GUI2) 

NFR19: Draw corresponding salinity profiles for temperature profiles 
displayed on Profile Composite Chart. (GUI2) 

NFR20: System must be able to export selected profiles. (DRM) 

NFR21: System must provide for interpolation of displayed data. 
(GUI2/DIM) 



NDR1: NIDAS must operate as a stand-alone system. (CSCI) 

NDR2: NIDAS must operate within the UNIX operating system 
environment. (CSCI) 

NDR3: NIDAS must execute within the X- Windows client-server model. 
(CSCI) 

NDR4: Windows displays must incorporate the Open Software 
Foundation (OSF) Motif Widget Library. (CSCI) 

NDR5: There must be a relational database management system (rdbms) 
specifically for NIDAS utilization. (DRM) 

NDR6: NIDAS must include an internal link to the rdbms for data 
retrieval. (DRM) 

NDR7: Ingestion of data into the rdbms will be accomplished by software 
external to NIDAS 

NDR8: Zoom capability for NIDAS Main Chart must replace enlarged 
display within Main Chart window; i.e. No pop-up windows for 
enlarged area. (GU12/DIM) 
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APPENDIX A 
GLOSSARY OF TERMS 


Charter - An interpolation module that creates a contour. 

Computer Software Configuration Item (CSCI) - a software application or 
a major component thereof. 

Computer Software Component (CSC) - a top level functional module 
within a computer software configuration item (CSCI). CSC’s are generally 
considered to be one structural level below the CSCI. 

Computer Software Unit (CSU) - low level software modules, usually at the 
function or subroutine level that perform specific functions within a CSC. 

Data Interactive Module (DIM) - NIDAS module that performs data 
manipulation functions and processing required for display and interpretation of 
data. 

Data Retrieval Module (DBM) - NIDAS module responsible for identifying, 
obtaining, and formatting data obtained from the NIDAS (NEONS) database. 

Graphical User Interface (GUI) - NIDAS module responsible for interfacing 
with the user andjcontrolling the functionality of the top level and main NIDAS 
display. 

Pixmap - "... is a window like structure memory in which graphics are drawn.” 
This graphics can be copied to the window. 

Project Area - An area of interest identified by a minimum and maximum 
latitude and longitude. 

Widget - a graphic device capable of receiving input from the keyboard and 
the mouse and communicating with an application or another widget by means of 
a callback. Every widget is a member of only one class and always has a window 
associated with it.” 
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APPENDIX B 


LIST OF ACRONYMS 


ASCII 

American Standard Code for Information Interchange 

CAST 

Center for Air Sea Technology 

Climo 

Climatology 

CSC 

Computer Software Component 

CSCI 

Computer Software Configuration Item 

CSU 

Computer Software Configuration Unit 

DBDR 

Database Design Requirement 

DBFR 

Database Functional Requirement 

DIM 

Data Interactive Module 

DOD 

Department of Defense 

DRM 

Data Retrieval Module 

GUI 

Graphical User Interface 

LAT 

Latitude 

LLT 

Latitude/Longitude/Time 

LON 

Longitude 

MAX 

Maximum 

MIN 

Minimum 

MOODS 

Master Oceanographic Observation Data Set 

MSU 

Mississippi State University 

NASA 

National Aeronautics and Space Administration 

NAVOCEANO 

Naval Oceanographic Office 

NDR 

NIDAS Data Requirement 

NEONS 

Navy Environmental Operational Nowcast System 

NFR 

NIDAS Functional Requirement 

NIDAS 

Naval Interactive Data Analysis System 

OSF 

Open Software Foundation 

PMI 

Program Modernization Initiative 

RDBMS 

Relational Database Management System 

SQL 

Strucnired Query Language 

3-D 

Three Dimensional 


APPENDIX C 


THE NIDAS RELATIONAL DATABASE MANAGEMENT 
SYSTEM (RDBMS) SPECIFICATION 


NIDAS accesses a NEONS database created specifically to support the 
CSCI. The database exists as a dedicated external and independent element of the 
system. Data ingestion into the database is also accomplished independently of 
NIDAS. NIDAS queries the database and retrieves requested data from it by 
calling NEONS software library functions. NEONS provides a data model for all 
generic data types that are required by NIDAS. These data types support the 
following operational datasets: 

• Bathythermograph observations in standard format (lit) 

• Volume 

• Coastlines (geographical) 

• LLT 

• Satellite imagery (image) 

Each dataset ''an be retrieved by the following parameters: 

• Coastline - Specify the resolution ( 1 ,3,8 , or 20 km) 

• LLT - lat, Ion, time, month, water depth, parameter, source, 
instrument, classification, cruise id 

Further information about NEONS, its structure and use is available in the 
NEONS design document (“Database Design Document for the Naval 
Environmental Operational Nowcast System”, Version 3.5). 
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APPENDIX D 


FUNCTIONAL AND DESIGN REQUIREMENTS FOR THE NIDAS 
RELATIONAL DATABASE MANAGEMENT SYSTEM (RDBMS) 


DATABASE FUNCTIONAL REQUIREMENTS (DBFR): 

DBFR1: Database must be capable of data retrieval. 

DBFR2: Data ingestion into flte rdbms is to be accomplished external to NIDAS 
as data becomes available using automated process (crontab, etc.). 

DBFR3: Data resident in the rdbms to include the last four past versions (at a 
minimum) in addition to the current dataset in a revolving data pool. 

DATABASE DESIGN REQUIREMENTS (DBDR): 

DBDR1: RDBMS engine must be Oracle. 

DBDR2: RDBMS model must be the Naval Environmental Operational Nowcast 
System (NEONS) Version 3.1.1, or later. 

DBDR3: Database must be compatible with NAVOCEANO Program 
Modernization Initiative (PMI) of 26 January 1993. 
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APPENDIX E 


THE NIDAS DEVELOPMENT ENVIRONMENT 


NIDAS has been developed in a Sun Microsystems SparcStation Model 10 
computer hardware environment. The operating system was SunOS version 4.1.3, 
including the resident SUN C compiler which was used to write the NIDAS 
software code. Some minor elements of NEONS have been written FORTRAN77 
(Sun FORTRAN77 version 1.4). Graphics support is provided by UNIRAS ag IX 
Toolmaster version 6v3b. The RDBMS engine is Oracle 7.1.x. The windowing 
environment consists of X~ Windows version XI 1 R5 and the OSF Motif widget 
set version 1.3. 


E-l 


APPENDIX F 

NIDAS STRUCTURES 

A C structure is a collection of data variables, pointers or other structures 

grouped together for the convenience of using a single variable name to reference 
or identify the whole group. The use and behavior of structures is covered in any 

C programming language textbook. 


The NIDAS structure is a 

collection of 21 pointers to subordinate 

structures that comprise the critical data framework of the NIDAS application. 
The NIDAS structure is defined as follows: 

typedef struct { 

label[MAX_LABEL]; 

LABEL 

FRONT_WINDOW 

♦fWindow; 

DATAJ5ELECT 

♦dataSelect; 

TIME.LOC 

♦locTime; 

COASTJ5TRUCT 

*coastS truct; 

Boolean 

isTypePresent[MAX JTYPE] ; 

BATHYJTYPEJSTRUCT 

♦bathyType; 

VOLUME TYPE_STRUCT 

♦volType; 

LLT TYPEJSTRUCT 

♦lltType; 

LINE TYPE_STRUCT 

♦lineType; 

IMAGE_TYPE_STRUCT 

♦imageType; 

NIDASZOOMDIALOG 

♦zoom; 

COLOR STRUCT 

♦colorStruct; 

VERT XSEC STRUCT 

♦vert_xsec; 

EXPORTJSTRUCT 

♦exportStruct; 

PROFILEJSOLATE 

♦profilelsolate; 

IMAGE_HISTOGRAM 

♦imageHist; 

IMAGE_PT_STRUCT 

♦imagePt; 

POLY GON_OPTIONS 

♦polyOpt; 

REGION JNFO 

♦regjnfo; 

PLOT_ENHANCE 

♦plot_enhanee; 

SYNTHETIC.PROFILE 

♦synProf; 

SYNTHETIC_STRUCT 

♦synthetic; 

> NIDAS; 


The following are source code listings for each elemental data structure 

contained in the NIDAS structure: 
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The DEFAULT.STRUCT Structure 


typedef struct < 
char xlabel[7]; 
char ylabel[7]; 
char moodsFile[61]; 
char auxlFile[61]; 
char aux2File[61]; 
char aeasFile[61]; 
char gdemFile[61]; 
char polyFile[61]; 
char grid2File[61]; 
char minLltDate[15]; 
char maxLltDate(15]; 
char polyFile[61]; 
char modasTempFile[61]; 
char modasSaIFile[61]; 
char modasSndSpdFile[61 ]; 
char nidasTempFile[61]; 
char nidasSaJFile[61]; 
char nidasSndSpdFile[6 1 ] ; 
double minjlat; 
double max_lat; 
double mm_ion; 
double max_lon; 
long min_wdepth; 
long max_wdepth; 
long min_class; 
long max_class; 
long min_cruise; 
long max_cruise; 
long min_inst; 
long maxjnst; 
long min_source; 


long max_source; 
long min.month; 
long max.month; 
long min_parm; 
long max_parm; 
float 

min_val[NUM_PROFILE_PLOT]; 

float 

max_val[NUM_PROFILE_PLOT] ; 
float 

mm_axi$[NUMJPROFILE_PLOTJ; 

float 

max_ax.i , > [NUM_PROFILE_PLOT] ; 
float x_delta; 
float y_delta; 
float bathy_step; 
float level; 
float lineWidth; 
float dotSize; 
float polyLineWidth; 
float polyDotSize; 
float isolateLineWidth; 
float isolateDotSize; 
float labelSize; 
int num_parm; 
int center_date; 
int dayl; 
int day2; 
int day3; 
int llt_julian_date; 

> DEFAULT.STRUCT; 

DEFAULT_STRUCT *defStruct; 
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WINDOW Structure 


typedef struct { 

Window window; 

GC gc; 

GC rgc; 

Boolean ifTherelsPixmap; 
Pixmap pixmap; 
float xmin; 
float xmax; 
float ymin; 
float ymax; 
float polyxniin; 
float polyxmax; 
float polyymin; 
float polyymax; 
int width; 
int height; 


int depth; 
int xexpose; 

int yexpose; 

int polyPoints; 
int backupPoints; 
int dPolyPoints; 
int dBackupPoints; 
int xstart; /* X coordinate of 

rubberband origin */ 
int ystart; /* Y coordinate of 

rubberband origin */ 
int xlast; /* X coordinate of 

rubberband extreme */ 
int ylast; /* Y coordinate of 

rubberband extreme */ 

> WINDOW; 


AXIS-TEXT Structure 


typedef struct { 

Widget text_color_w; 
Widget marker_color_w; 
Widget title_color_w; 
Widget gridLine_color_w; 
Widget line_style_w; 
Window textWindow; 
Window markerWindow; 
Window titleWindow; 
int textColor; 
int markerColor; 
int titleColor; 
int gridLineColor; 


int gridLineStyle; 
int markerXStep; 
int markerYStep; 
float texts ize; 
float markerSize; 
float titleSize; 
char x_text[31]; 
char y_text[31]; 
char title_text[100]; 
char *text_fontName; 
char *marker_fontName; 
char *title_fontName; 

> AXIS _TEXT; 


The MAIN_ WINDOW Structure 


typedef struct { 
double min.lat; 
double max_lat; 
double min_lon; 
double max_lon; 
double cmer; 
double bpar; 
float x_delta; 
float y_delta; 


float lon_arr[MAXJPOINTS]; 
float lat_arr[MAX_POINTS]; 
float dlon airfMAX POINTS] 
float dlat_arr[MAX_POINTS]; 
float dlon[MAX_POINTS]; 
float dlat[MAX_POINTS] ; 
int proj_type; 

AXIS_TEXT *axisText; 

WINDOW *windowParm; 

> MAIN.WINDOW; 


The PROFELE_WINDOW Structure 


typedef struct < 
float xarr[MAX_POINTS]; 
float yarr[MAX_POINTS]; 
float xpts [MAX_POINTS ] ; 
float ypts [M AX_POINTS ] ; 

AXIS_TEXT *axisText; 

WINDOW *windowParm; 

> PROFILE_WIND O W; 

The FRONT-WINDOW Structure 


typedef struct < 

MAIN.WINDOW *mainWin,dow[NUM_MAIN_PLOT]; 
PROFILE.WINDOW *profUeWindow[NUM__PROFILE_PLOT]; 
Window window; 

Cursor cursor; 

Display *display; 

Widget statusDialog; 

Widget draw[NUM_PLOT_TYPE] ; 

Widget view_form; 

Widget mulCi_view_foim; 

Widget remark; 

Widget front-page; 

Widget parmOption; 

Widget xlabel; 

Widget xtext; 

Widget ylabel; Widget ytext; 
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Widget 

dataBtn; 

Widget 

volToolsLabel; 

Widget 

exportBtn; 

Widget 

imageToolsLabel; 

Widget 

zoomBtn; 

Widget 

synToolsLabel; 

Widget 

dummyPolyBtn; 

Widget 

windowLabel; 

Widget 

polygonBtn; 

Boolean 

dataFlag; 

Widget 

proflsolateBtn; 

Boolean 

sessionFlag; 

Widget 

polyOptBtn; 

Boolean 

polyOptFlag; 

Widget 

multiViewBtn; 

Boolean 

proflsolateFlag; 

Widget 

transectBtn; 

Boolean 

imageHistFlag; 

Widget 

singleVolBtn; 

Boolean 

multiViewFlag; 

Widget 

imageHistBtn; 

Boolean 

syntheticFlag; 

Widget 

imagePtBtn; 

Pixel 

selected_color; 

Widget 

sessionBtn; 

Pixel 

unselected_color; 

Widget 

syntheticBtn; 

char 

*sw_env; 

Widget 

repaintBtn; 

char 

*exp_env; 

Widget 

defaultBtn; 

int 

numjabel; 

Widget 

windowOptBtn; 

int 

cur_btn; 

Widget 

lastPolyBtn; 

int 

windowld; 

Widget 

erasePolyBtn; 

int 

lastPolyWindow; 

Widget 

plotEnhanceBtn; 

int 

activeLltlndex; 

Widget 

dataDialog; 

long 

activeLltld; 

Widget 

polyOptDialog; 

Widget 

activeLltTog; 

Widget 

dataToolsLabel; 

float 

sstMinVal; 

Widget 

analyToolsLabel; 

float 

sstMaxVal; 

Widget 

lltToolsLabel; 

float imageMinval; 

float imageMaxVal; 

> FRONT. WINDOW ; 


The PLOT_ENHANCE Structure 

typedef struct < 

Widget width_w; 

Widget height_w; 
int wiudow_type; 

int pix.width; 

int pixjieight; 

WINDOW ’"windowParm; 

> PLOTJENHANCE; 
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The DATAJSELECT Structure 

The TIME_LOC Structure 

typedef struct < 

typedef struct { 

Widget datajist; 

DATE $tart_date; 

Widget data_label; 

DATE end.date; 

Widget displayBB; 

double minjat; 

int type; 

double min_lon; 

int data_pos; 

double maxjat; 

int tog_x; 

double maxjon; 

int tog_y; 

double start_hour; 

int tog_count; 

double end_hour; 

char *togjype[30]; 

> TIMEJLOC; 

> DATAJSELECT; 


The DATAjSTRUCT Structure 

typedef struct { . 

float *bathy; 

Widget dialog; 

float *data; 

Widget max_text; 

float *projLon; 

Widget min_text; 

float *projLat; 

Widget step_text; 

float step; 

Widget isoline_color_w; 

float defStep; 

Widget isoline Jine_width_scale; 

float isolineLineWidth; 

Widget label_color_\v; 

float deflsolineLineWidth; 

Widget label_size_scale; 

float labelSize; 

Widget decimal_scale; 

float defLabelSize; 

Boolean ifTherelsPixmap; 

int isolineColor; 

Boolean isData; 

int deflsolineColor; 

Boolean isLabel; 

int labelColor; 

double ’"Ion; 

int defLabelColor; 

double *lat; 

int numOfDec; 

float minVal; 

int defNumOfDec; 

float maxVal; 

int rowcnt; 

float defMinVal; 

•nt colcnt; 

float defMaxVal; 

> DATA.STRUCT; 
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The V OL_OPT_STRUCT Structure 


typedef struct < 

Widget opt_dialog; 

Widget leveljist; 

Widget color_w; 

Widget poly_color_w; 

Widget isolate_color_w; 

Widget line_width_scale; 

Widget dot_size_scale; 

Widget poly_line_width_scale; 
Widget poly_dot_size_scale ; 
Widget isolate Jine_width_scale; 
Widget isolate_dot_size_scale; 
Boolean islsoline; 

Boolean isLocation; 

Boolean isProfile; 
float lineWidth; 
float defLineWidth; 
float dotSize; 
float defDotSize; 


float polyLineWidth; 
float defPolyLineWidth; 
float polyDotSize; 
float defPolyDotSize; 
float isolateLineWidth; 
float deflsolateLineWidth; 
float isolateDotSize; 
float deflsolateDotSize; 
int color; 
int defColor, 
int polyColor, 
int defPolyColor; 
int isolateColor; 
int deflsolateColor; 
int profile_count; 
int *profile_array; 
int *color_array; 
int defLevelPos; 
int levelPos; 

> VOL_OPT_STRUCT; 


The COAST.STRUCT Structure 


typedef struct { 
Widget dialog; 
Widget opt_dialog; 
Widget coast_text; 
Widget color_w; 


Boolean ifTherelsPixmap; 
char coa$t[15]; 
char defCoast[15]; 
int color; 
int defColor; 

> COAST.STRUCT; 


The VOL.STRUCT Structure 


typedef struct < 
Widget vrsnjist; 
Boolean isOption; 
Boolean isClimo; 
Boolean ♦emptyFlag; 
int parmFlag; 
char parm[21]; 
char month[21]; 
char date[21]; 


float *lvl_val; 
int lvl_cnt; 
double min_lon; 
double maxjon; 
double minjat; 
double max_lat; 
float x_int_deg; 
float y_inLdeg; 
float pack_null; 


long vol_id; 

DATA.STRUCT 

♦dataStruct; 

VOL_OPT_STRUCT 
’"volOptS truer, 

} VOL.STRUCT; 
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The FRONT_STRUCT Structure 


typedef struct { 

Widget sep.tog; 

Widget datejist; 

Widget color_w; 

Boolean ifTherelsPixmap; 
Boolean isData; 
char date[15]; 


char dates [MAX_DATES] [15]; 
int numjdays; 
float freddy; 
int color; 
int defColor; 

Boolean sepColors; 

> FRONT.STRUCT; 


The LLT_REG_HEADER Structure 


typedef struct { 
double minLat; 
double maxLat; 
double minLon; 
double maxLon; 
double defMinLat; 
double defMaxLat; 
double defMinLon; 
double defMaxLon; 
long minPann; 
tong maxParm; 
long defMinParm; 
long defMaxParm; 
char *vrsnName[12]; 
char minDate[15]; 
char maxDate[15]; 
char defMinDate[15]; 
char defMaxDate[15]; 
int vrsnCnt; 
int parm; 
int numOfProfiles; 
int selectionjype; 


int lvl_cnt; 
float *lon; 
float *lat; 
float *lvl_val; 
float pack_null; 

Boolean ifTherelsPixmap; 
Widget dialog; 

Widget min_toggle; 
Widget max_toggle; 
Widget parm_scale; 
Widget vrsn_toggle; 
Widget latjext; 

Widget lonjext; 

Widget minjat_text; 
Widget max Jat_text; 
Widget min_lon_text; 
Widget maxJon_text; 
Widget min_time_text; 
Widget max Jime_text; 
Widget min_parm_text; 
Widget max„parm_text; 

> LLT_REG_HEADER; 
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The LLT.OPTJiEADER Structure 


typedef struct < 
int dayl_color, 
int day2_color; 
int day3_co!or; 
int defDaylColor; 
int defl>ay2Color; 
int defDay3Color; 
int dayi; 
int day2; 
int day3; 
int defDayl; 
int defDay2; 
int defDay3; 
int centerDate; 
int sstColor; 
int defCenterDate; 
int defSstColor, 
int polylColor; 
int poly2Color; 
int poly3Color, 
int defPolylColor; 
int defPoly2Color; 
int defPoly3Color; 
int isolateColor; 
int deflsolateColor; 
int profile_count; 
int *profile_array; 
int *color_array; 
float minsst; 
float maxsst; 
float lineWidth; 
float dotSize; 
float polyLineWidth; 


float polyDotSize; 
float isolateLineWidth; 
float isolateDotSize; 
float defLineWidth; 
float defDotSize; 
float defPolyLineWidth; 
float defPolyDotSize; 
float deflsolateLineWidth; 
float deflsolateDotSize; 

Boolean isSst; 

Boolean isManualSst; 

Boolean isLocation; 

Boolean isProfile; 

Boolean isDepth; 

Widget opt_dialog; 

Widget dayl_color_w; 

Widget day2_color_w; 

Widget day3_color_w; 

Widget dayljext; 

Widget day2_text; 

Widget day3 Jext; 

Widget polyl_color_w; 

Widget poly2_color_w; 

Widget poly3_color_w; 

Widget sst_color_w; 

Widget isolate_color_w; 

Widget center_date_text; 

Widget line_width_scale; 

Widget dot_size„scale; 

Widget poly Jine_width_scale; 
Widget poly_dot_size_scale; 
Widget isolate_line_width_scale; 
Widget isolate_dot_size_scale; 

> LLT_OPT_HEADER; 
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The LLT..DATA Structure 


typedef struct { 

float ipat; 

double lat; 

float imass; 

double Ion; 

float iprov; 

double hour; 

float llt_bot_dpthl; 

DATE date; 

float llt_bot_dpth2; 

float *parm[NUM_PARM]; 

float cycl.cnt; 

float *depth; 

float cyc2_cnt; 

float clasld; 

float extra; 

int numOfPoints; 

float rpln_cnt; 

int julian; 

float clas_num; 

float pann_ljnanie; 

float inst_num; 

float hdr_txt[60]; 

float $rc_num; 

float nprof; 

float cruise_num; 

float prof_flagf8]; 

char ident[10]; 

float jprof; 

> LLT_DATA; 

The LLTJKEADER Structure 

typedef struct { 

Widget water_depth_text; 

long minClass; 

Widget time_toggle; 

long maxOass; 

Widget min_class_text; 

long minlnst; 

Widget max_class_text; 

long maxlnst; 

Widget min_inst_text; 

long minSource; 

Widget max_inst_text; 

long maxSource; 

Widget min_src_text; 

long minMonth; 

Widget max_src_text; 

long maxMonth; 

Widget min_month_text; 

long minWdepth; 

Widget max_month_text; 

long maxWdepth; 

Widget min_wdepth_text; 

long minCruise; 

Widget max_wdepth_text; 

long maxCruise; 

Widget min_cruise_text; 

int month; 

Widget max_cruise_text; 

int defMonth; 

Boolean isData; 

Widget c:lass_list; 

Boolean selectTime; 

Widget instjist; 

Boolean selectMonth; 

Widget sourcejist; 

LLT REG HEADER *lltRcgHeader; 

Widget month Jist; 

LLT OPT HEADER *lltOptHeader; 

Widget cruise Jdjicxt; 

> LLT HEADER; 
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The DEF_LLT_HEADER Structure 


typedef struct < 
long defMinClass; 
long defMaxGass; 
long defMinlnst; 
long defMaxInst; 
long defMinSource; 
long derMaxSource; 


long defMinWdepth; 
long defMaxWdepth; 
long defMinMonth; 
long defMaxMonth; 
long defMinCruise; 
long defMaxCruise; 
int defMonth; 

> DEF_LLT_HE ADER ; 


The LLT_STRUCT Structure 

typedef struct < 

LLTJHEADER *lltHeader, 
DEFJLLT_HEADER *defLltHeader; 
LLT.DATA *lltData[MAX_OBS]; 
> LLTJSTRUCT; 


The IMAGE.STRUCT Structure 


typedef struct < 

Boolean ifTherelsPixmap; 
Boolean isData; 

Pixmap pixmap; 
long imageld; 
float minVal; 
float maxVal; 
float step; 
float defMinVal; 
float defMaxVal; 
float defStep; 
float minTemp; 
float maxTemp; 
float sstMinVal; 
float sstMaxVal; 
float ratio; 

Widget dialog; 


Widget opt_dialog; 

Widget imagejist; 

Widget min_text; 

Widget max_text; 

Widget step_text; 
REG.GEOM geom; 
unsigned short *sbuff; 
unsigned short *newlmage; 
int rowent; 
int eolent; 
int minPixel; 
int maxPixel; 
double min_lon; 
double max Jon; 
double minjat; 
double max_lat; 

> IMAGE.STRUCT; 
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The COLOR_STRUCT Structure 


typedef struct { 

unsigned long colors[NUM_OF_COLOR]; 

unsigned long black; 

unsigned long white; 

unsigned long blue; 

unsigned long whiteyellow; 

unsigned long skyblue; 


unsigned long tan; 
unsigned long cyan4; 
unsigned long bluegrey; 
unsigned long bluesteel; 
unsigned long blueblack; 
unsigned long whitegreen; 
>COLOR_STRUCT; 


The VERT_XSEC_STRUCT Structure 


typedef struct { 

Widget transectDialog; 
Widget spacing_w; 
Widget rain_depth_w; 
Widget max_depth_w; 
Widget interval_.w; 
Boolean isData; 
int num_poly_pts; 
int iend; 
int type; 
int lvl_cnt; 
int rowent; 
int eolent; 
char parm_name[31]; 
float pt_lon[2]; 


float ptjat[2]; 
float *gtlat; 
float *gtlon; 
float *gtd; 
float *data; 
float *bathy; 
float spacing; 
float xmax; 
float *depth; 
float minDepth; 
float maxDepth; 
float interval; 
float offset; 
float pack_null; 

> VERT_XSEC_STRUCT; 


The EXPORT.STOUCT Structure 


typedef struct { 

Widget exportDialog; 

char header[MAX_FILE_NUM][60]; 

char fileName[MAX_FILE_NUM] [51]; 


Boolean 

onOffFlag[MAX_FILE_NUM]; 
int fileType; 

> EXPORT.STRUCT; 
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The NIDASZOOMDIALOG Structure 


typedef struct 
^NIDASZOOMDIALOG { 

int startx; /* X grid coordinate of first zoom comer */ 

int starty; /* Y grid coordinate of first zoom comer */ 

int endx; /♦ X grid coordinate of second zoom comer */ 

int endy; /* Y grid coordinate of second zoom comer */ 

float xmin; 
float xmax; 
float ymin; 
float ymax; 

Boolean zoomOniy; 

Boolean overlay; 

} NIDASZOOMDIALOG; 


The SYNTHETIC J’ROFILE Structure 

typedef struct 

_SYNTHETICPROFILE < 

int synPoints; 

int numOfSynPoints; 

float synxarr[MAX_EDIT_POINTS]; 

float synyarr[MAX_EDIT_POINTS ] ; 

> SYNTHETIC PROFILE; 


The PROFILE JSOLATE Structure 


typedef struct JPROFILE JSOLATE { 
Widget dialog; 

Widget button; 

Widget list; 

Widget label; 

Widget exportBtn; 

Widget deleteBtn; 


Widget editBtn; 
Boolean flag; 
int nuni_select; 
int ’"select; 
int type; 

int isNewSyntliEdit; 
} PROFILE JSOLATE; 
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The IMAOE_HISTOGRAM Structure 


typedef struct JMAGE.HISTOGRAM < 
Widget imageDialog; 

Widget draw; 

Widget min_text; 

Widget max_text; 

Widget min_tog; 


Widget max_tog; 
int max_pixel; 
int minMaxTog; 
int type; 

>IMAGE_HISTOGRAM; 


The IMAGE_PT_STRUCT Structure 


typedef struct _IMAGE_PT_STRUCT < 
Widget dialog; 

Widget lonLabel; 

Widget latLabel; 


Widget pixelLabel; 
Widget tempLabel; 

> IMAGE J>T_STRUCT; 


The POLYGON_OPTIONS Structure 


typedef struct JPOLYGON_OPTIONS < 
Widget vertex_symboLwidget; 
Widget vertex_color_w; 

Widget edge_color_.w; 
int vertexColor; 


int edgeColor; 
int vertexSymbol; 
float vertexSize; 
float edgeLineWidth; 
POLY GON_OPTIONS; 


The SYNTHE11C_STRUCT Structure 


typedef struct _SYNTHETIC_STRUCT < 
Widget dialog; 

Widget togs[NlJM_S YN_PROF+ 1 ] ; 
Widget line_color_w; 
int lineColor; 
float lineWidth; 
int type; 

int num_syn_pts[NUM_SYN_PROF] 
[NTJM_S YNJTYPE] ; 

Boolean hasData[NUM_SYN_PROF] 
[NUM_S YN_T YPE j ; 

Boolean isFirstDepthZ<iro; 
float parm[NUM_SYN_PROF] 

[N UM_S YN_TYPE] 
IMAX.SYN^POINTS]; 
float dep*h[NUM_S YN.PROF] 
(NUM.SYN TYPE] 


[MAX_SYN_POINTS]; 
float Ion arr[MAX POINTS]; 
float lat_arr[MAXJPOINTS]; 
int polyPoints; 
int backupPoints; 
char fileName[5lj; 
float Ion; 
float lat; 
int year; 
int month; 
int day; 
float hour; 
int iprov; 
int ireg; 

> SYNTHETIC_STRUCT; 


F- 14 


The VOLUME_TYPE_STRUCT Structure 


typedef struct { 

VOL.STRUCT **volStruct; 
NAME_STRUCT *vol_names; 
int num_voi; 

> VOLUME^TYPE.STRUCT; 


The LLT_TYPE_STRUCT Structure 

typedef struct < 

LLT.STRUCT **UtStruct; 

NAME.STRUCT *llt_names; 
int numjllt; 

> LLT_TYPE_STRUCT; 


The LINE_TYPE_STRUCT Structure 

typedef struct < 

FRONT_STRUCT **lineStruct; 

NAMEJ5TRUCT *line_names; 
int numjine; 

> LINE_TYPE_STRUCT; 

The IMAGE_TYPE_S TRUCT 
Structure 

typedef struct { 

IMAGE_STRUCT **irnageStruct; 

NAME_STRUCT *image_names; 
int numjmage; 

> IMAGE_TYPE_STRUCT; 
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APPENDIX G 

THE NIDAS DEFAULT CONFIGURATION FILE 


Default values for parameters that are critical to NIDAS operation are 
maintained in a user default file. Users should not create their own user default 
file. Instead, the file should be provided by NIDAS site managers. Site managers 
should ensure that file privileges are restricted to “read only”. Any changes to. this 
file could cause the application to fail. All values and colors may be changed 
through interaction with NIDAS, except minlat, maxlat, minion, and maxlon. 
When the main window of NIDAS is broughtup, the appliction will look for the 
file “nidasConfig.def ’ in the NIDAS installation directory. If the “nidasConfig.def” 
file cannot be located, the application will fail. The format for the 
“nidasConfig.def * default file is as follows: 


22.0 31.0 47.0 74.0 

2.0 2.0 
wvs_8km_cst 
WHITE 

ORANGE 100.0 

10.0 35.0 0.0 400.0 

30.0 40.0 0.0 400.0 

1425.0 1525.0 0.0 400.0 

20.0 30.0 0.0 400.0 
0.0 20.0 0.0 400.0 

10.0 35.0 30.0 40.0 
Temp 

Depth 

3 

sea_temp 

temp 

temp_sal 

YELLOW 

center_date 30 

GREEN 15 

GREEN 0 

GREEN 0 

sst_color BLUE 

polygonl_color ORANGE 

polygon2_color YELLOW 

polygon3_color BLACK 

classification 0 10001000 

sourcecode 0 99 


/* min and max latitude and longitude */ 

/* longitude and latitude axis ticks */ 

/* resolution of coastline */ 

/* color of the coastline */ 

/* Bathymetry color and contour interval */ 
/* min and max temperature and depth */ 

/* min and max salinity and depth */ 

/* min and max sound speed and depth */ 

/* min and max density and depth */ 

/* min and max conductivity and depth */ 

/* min and max temperature and salinity */ 
/* x axis label */ 

/* y axis label */ 

/* number of parameters */ 

/* sea temperature */ 

/* temperature */ 

/* temperature salinity */ 

/* front color */. 

/* center date for LLT data */ 

/* day 1 time color and window *1 
/* day 1 time color and window */ 

/* day 1 time color and window *1 
/* sea surface temperature color */ 

/* day 1 polygon color */ 

/* day 2 polygon color */ 

/* day 3 polygon color */ 

/* min and max classification for LLT */ 

/* min and max source for LLT */ 
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inst_type 0 99 

/* 

months 1 12 

/* 

cruise 0 1000000000 

/* 

parm 2 3 

i* 

water_depth -99 10000000 

/* 

level 0.0 

/* 

otis_data.ouv 

/* 

gdem_data.out 

/* 

moods_data.out 

/* 

goods_dafa.out 

/* 

vol_data.cut 

/* 

polyExport.out 

/* 

./modas.temp.out 

/* 

,/modas.sal.out 

t* 

./modas.sndspd.out 

i* 

./nidas_temp.out 

/* 

./nidas_sal.out 

t* 

./nidas_sndspd.out 

/* 


min and max instrument for LLT */ 

min and max months for LLT */ 

min and max cruise number for LLT */ 

min and max parameters for LLT */ 

min and max water depth for LLT */ 

VOLUME level to be plotted */ 

otis output file */ 

gdem output file *1 

moods output file */ 

goods output file */ 

volume output file */ 

polygon output file */ 

modas temp output file */ 

modas salinity output file */ 

modas sound speed output file */ 

NIDAS temp output file */ 

N1DAS salinity output file */ 

NIDAS sound speed output file */ 
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APPENDIX H 


NIDAS REGION CONFIGURATION SYSTEM DESIGN 


1.0 SYSTEM OVERVIEW 

The NIDAS Region Configuration System (NRCS) is a tool that provides 
facilities for defining geographical regions. NRCS also provides for defining 
different environmental data types and formats for each defined region. The 
following sections describe in detail the design of the tool and its functionality. 
NRCS has to be used to setup project areas and datasets prior to ingesting data and 
using NIDAS. 

2.0 MAIN WINDOW GRAPHICAL USER INTERFACE (GUI) 

2.1 CftiHponents 

Figure 1 displays the main window Graphical User Interface dialog of 
NRCS. The main components of the dialog are project area list, dataset list, globe 
map, menu bar, function buttons, and remark area. The project area list contains a 
list of project areas previously defined. The dataset list contains a list of datasets 
previously defined. The globe map allows for the selection of any region of the 
globe with the aid of the mouse. The function buttons allow certain operations to 
be performed for any project area and/or dataset selected. These functions are 
project area information, dataset information, add project area, add dataset, delete 
dataset, delete project area, and zoom. The remark area displays the current status 
of any user interaction with the tool. 

2.2 Functionality 

The NRCS Main Window GUI design employs the X, Motif, and UNIRAS 
ag/X Toolmaster libraries. Input to the NRCS top level window GUI is via the 
REGION-INFO data structure. The function allocMemoryO is called to allocate 
memory for the NRCS FRONT-PAGE data structure, while lnltFrontPage() 
initializes the FRONT-PAGE data structure. The function getColorPixel() gets 
the pixel value of specified colors. The function createFrontPage() creates the 
layout for the NRCS main window. Within this function, createPulldownO 
creates the menu-bar. The function createGlobeMapO creates the globe map and 
its components. 
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Figure 1. Illustration of the NRCS Main Window 
Graphical User Interface (GUI) Display Screen. 


The function getRegionlnfoO retrieves a list of predefined project areas 
from the database and lists them in the project area list. The function 
brwsProjectAreaO is called when a selection is made on the project area list to 
register the selection. The appropriate functions are called from within to draw the 
rectangle across the selected region in the globe. The function getDatasetLlst() 
is called from within this function to retrieve all the datasets available for the 
selected project area. Latlon2Cursor(), Cursor2LatLon(), and Zoom 
Cursor2Latlon() are associated with transforming values between the xy 
coordinates of the cursor and the latitude/longitude values and vice versa. 
LatIon2Map() is called to transform the latitude/longitude values into a rectangle 
across the region in the globe. 
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2.2.1 pile Pulldown Menu 


The menu-bar “File" button displays a reset and an exit option. The “Reset" 
option calls resetMapO to erase any user selected project area and also erase the 
resulting rectangle drawn across the selected project area in the globe map. The 
“Exit” option calls exitRegAnalysisO to free widget memory and exit from the 
application. 

2.2.2 Function Buttons 

The function buttons are composed of the following buttons: 1) Project Area 
Information, 2) Dataset Information, 3) Create Project Area, 4) Create Dataset, 
5) Delete Project Area, 6) Delete Dataset, and 7) Zoom. 

2 . 2 . 2.1 Erojest Area-info 

When the Project Area Info button is selected, sefupRegionlnfoO is 
called. This function checks if a project area is selected and then allocates memory 
for the nrcs REGIONJNFO data structure. The function InitReglonCreateO 
initializes the REGIONJNFO data structure and reglonlnfoO is then called to 
create and display the “Project Area Info” dialog as shown in Figure 2. This 
dialog displays information such as name of the project area, area description, the 
creator of the project area, date the project area was created, the project name, and 
classification of the project area. The function retrieveRegionlnfoO is called to 
retrieve these information for the selected project area from the database and 
display them. The button “Geoglnfo" when selected will call setupGeoglnfoO to 
allocate memory for the NRCS GEOGLOCJNFO data structure and to initialize 
the structure. The function geoglnfoO is then called from within to create and 
display the “Project Boundary Info”. This dialog displays min/max latitude and 
longitude values. Th> function display GeogValuesO is called to retrieve and 
display these values. 

2.2.2.2 Dataset, info 

When the Datasetlnfo button is selected, setupDsetInfo() is called. This 
function checks if a dataset is selected and then allocates memory for the NRCS 
DATASETJNFO data structure. This structure is initialized by initDsetInfo(). 
The function datasetlnfoO is called to create and display the “Dataset 
Information" dialog, as shown in Figure 3. This dialog provides information such 
as dataset name, classification, type, dataset creator, description, and date created. 
The function getDsetlnfoO is called to retrieve and display these values. The 
“Details" and Options" buttons provide greater details on the dataset based on data 
type (LLT, Volume, Bathymetry, or Image). 
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Figure 2. Project Area Info Dialog 


2.2.2.2.1 LLT 

When the “Details button is selected, addDisplayDelDset() is called to 
display detailed information about the dataset. For the LLT data type, 
UtDatalnfoO is called to create and display the “LLT Data Information” dialog. 
This dialog displays information such as range, color, and polygon color for three 
time range subsets and location, profile, and depth flags. The function 
getLltlnfoO retrievels and displays the required information. There are no 
“Options” for LLT. 
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Figure 3. Dataset Information Dialog 


1 . 2 . 2 . 2.2 Volume 

When the “Details” button is selected, addDisplayDelDset() is called to 
display detailed information about the dataset. For the Volume data type, 
volDatalnfoO is called to create and display tine “Volume Data Information” 
dialog. This dialog displays information such as climatology flag; min/max latitude 
and longitude; north-south resolution; east-west resolution; row count; column 
count; depth count; depth values; and input grid flag. When the “InputGrid” button 
is selected setup VolVrsnsO is called to create and display the “Versions” dialog. 
This dialog displays a list of versions for the currently selected volume dataset 
which can be selected as input for the LLT data type. The function getVolInfoO 
retrieves and displays the required information. 

When the “Options” button is selected for the Volume data type, 
addDeIDispIayOptions() is called to create and display the “Volume Data 
Information” options dialog. This dialog displays information such as minimum, 
maximum, contour interval, transect min/max; and color. The function 
getVolInfoO retrieves and displays the required information. 
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2.2.2.23 Bathymetry 


When the “Details” button is selected, addDisplayDelDsetO is called to 
display detailed information about the dataset. For the Bathymetry data type, 
bathyDatalnfoO is called to create and display the “Bathy Data Information” 
dialog. This dialog displays information such as min/max latitude and longitude; 
row count; column count; and horizontal resolution. The function 
getBathylnfoO retrieves and displays the required information. 

When the “Options button is selected for the Bathymetry data type, 
addDelDisplayOptionsO is called to create and display the “Bathy Data 
Information” options dialog. This dialog displays information such as minimum, 
maximum, contour interval; and color values. The function getBathylnfoO 
retrieves and displays the required information. 

2.2.2.2A Image 

When the “Details” button is selected, addDisplaydelDsetO is called to 
display information about the dataset. For the Image data type, imageData 
InfoO is called to create and display the “Image Data Information” dialog. This 
dialog displays information such as satellite name, sensor name, and band. The 
function getlmagelnfoO retrieves and displays the required information. 

When the “Options” button is selected for the Image data type, 
addDelDisplayOptionsO is called to create and display the “Image Data 
Information” options dialog. This dialog displays information such as minimum, 
maximum, and contour interval. The function getlmagelnfoO retrieves and 
displays the required information. 

2.2.23 

When the Project Area Add button is selected, setupRegionCreateO is 
called. This function allocates memory for the NRCS REGION_INFO data struc- 
ture and calls initRegionCreateO to initialize it. The function regionlnfoO is 
then called to create and display the “Project Area Create” dialog similar to the 
“Project Area Info” dialog shown in Figure 2. The button “Geoglnfo” when 
selected will call setupGeogCreate() to allocate memory for the NRCS 
GEOGLOC_INFO data structure and to initialize the structure. The function 
geoglnfoO is then called from v thin to create and display the “Project Boundary 
Create”. The dialog will allow for specifying the min/max latitude and longitude 
values. If the specified values are out of bounds, then the default values are 
assigned. When the “Add” button is selected, addNewRegion() is called. The 
coordinates of the project area are first checked and then insAnalysisRegO is 
called to create a new project area and store the information in the database. 
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2.2.2A Dataset Create 


When the AddDataset button is selected, setupDsetCreateO is called. This 
function checks if a project area is selected and then allocates memory for the 
NRCS DATASET JNFO data structure. This structure is initialized by InltDset 
Info(). The function datasetlnfoO is called to create and display the “Dataset 
Add” dialog similar to. the “Dataset Info” dialog shown in Figure 3. The dataset 
type can be set by selecting any type from the pop-up menu which appears when 
the ' OataType” button is selected. When a particular data type is selected from the 
pop-up menu showDataDialogO is called to display the selected data type dialog. 
Memory is allocated by calling allocDataStruct(). The function addDisplayDel 
DsetO then calls the appropriate function, depending on the data type, to bring up 
the editing dialog. The editing dialog for each dataset is similar to the “Dataset 
Info” dialogs discussed in Sections 2.2, 2.2.1 through 2.2.22 A. 

2.2.2.5 Project Area Delete 

When the Project Area Delete button is selected, setupRegionDeleteO is 
called. This function checks if a project area is selected and then allocates memory 
for the nrcs REGIONJNFO data structure and the GEOG_LOC data structure. 
The function initRegionCreate() initializes the REGIONJNFO data structure 
and regionlnfoO is then called to create and display the “Project Area Delete” 
dialog similar to the “Project Area Info” dialog shown in Figure 2, with the excep- 
tion of a “Delete” button. Selecting the “Delete” button will call deleteReglon() 
to delete the project area. This function first deletes any datasets defined in the 
project area and then deletes the project area. The database function 
delAnalysisRegO is called to execute the delete. 

2.2.2.6 Dataset Delete 

When the DelDataset button is selected, setupDsetI)elete() is called. This 
function checks if a dataset is selected and then allocates memory for the NRCS 
DATASET_INFO data structure. This structure is initialized by initDsetInfo(). 
The function datasetlnfoO is called to create and display the “Dataset Delete” 
dialog similar to that of the “Dataset Information.” dialog shown in Figure 3, with 
the exception of a “De)e^ ‘ button. Selecting the “Delete” button will call 
delDatasetO to delete th«. selected dataset and the associated information. The 
database functions are used for this purpose. For BATHY dataset, 
delBathylnfoO is called. For VOLUME, delVolDataset() is called. For 
IMAGE, delLImagelnfoO is called. For LLT, delLltlnfo2() is called. 

If the dataset type is VOLUME and if the dataset is also a base input grid for 
LLT, then warnForOutputGridO is called to display a confirmation dialog. 
Selecting OK will call delVolDatasetO to complete the delete. 
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2222 ZOOM 


When the “Zoom” button is activated, setupZoom() is executed. This 
function creates the zoom dialog and registers the required functions. The function 
initZoomRubberBandQ initializes the rubber band data structure while zoom 
DataDialogO sets the various coordinates. The function zoomDrawlngPress() 
is activated when the user clicks the left mouse button on the globe map to start 
drawing a rectangle. The function zoomDrawingMotion() is activated when the 
user drags the mouse across a region in the map. The function zoom 
DrawingReleaseO is activated when the user releases the left mouse button to 
complete the drawing of the rectangle across the region to be zoomed and also 
produce a pop-up dialog containing the outline of the zoomed region. The zoomed 
area can be used to define the min/max latitude and longitude values for a new 
project area. 
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APPENDIX I 


DATABASE ADMINISTRATOR TOOLS DESIGN 


1.0 SYSTEM OVERVIEW 

The Database Administrator Tools (DBA. Tools) application is a tool that 
provides facilities for performing various database administrative functions for 
NIDAS. Among the facilities provided are database access control, table 
maintenance, and data maintenance such as inventory, delete, and ingest. The 
following sections describe in detail the design of the tool and its functionality. 

2.0 MAIN WINDOW GRAPHICAL USER INTERFACE (GUI) 

2.1 Components 

Figure 1 displays the main window Graphical User Interface dialog of DBA 
Tools. The main components of the dialog are project area list, globe map, menu 
bar, and remark area. The project area list contains a list of predefined project 
areas. The globe map allows for visual of location of the pre-define project area. 
The remark area displays the current status of any user interaction with the tool. 

2.2 Functionality 

The DBA Tools Main Window GUI design employs the X, Motif, and 
UNIRAS ag/X Toolmaster libraries. Input to the Dba Tools top level window GUI 
is via the DBAT data structure. The function allocMemoryO is called to allocate 
memory for the DBAT data structure and its sub structures, while 
InitMalnScreenO initializes the DBAT data structure. The function 
getColorPixelO gets the pixel value of specified colors. The function 
createMalnScreenO creates the layout for the Dba Tools main window. Within 
this function, AcIGetUserInfo() retrieves the various access permissions of the 
user currently logged. If the table containing the access information is empty then 
this table is initialized with the DBA access information via AclAddNewUser(). 
If the table does not contain information pertaining to the user currently logged 
then the error message “User not authorized to use dbatool. Check with dba.” is 
displayed and the application exits. 

The function createPulldownQ creates the menu.bar, while 
createGXobeMapO creates the globe map and its components. The function 
getRegionlnfoO retrieves a list of predefined project areas from the database 
anu lists them in the project area list. The function brwsProjectAreaO is called 
when a selection is made on the project area list to register the selection. This 
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function calls (JpdateRegion() to draw the rectangle across the selected region in 
the globe and dataFormO to create and display the “DATA SELECTION” dialog 
shown in Figure 2. 



Figure 1. Illustration of the Dba Tools Main Window 
Graphical User Interface (GUI) Display Screen 

The database function getDataTypeListQ is called to retrieve and display a 
list of data types available for the project area in the “DATA TYPE” list. When a 
data type is selected from this list, typeBnvsO is called to retrieve and display the 
list of datasets in the “DATASET" list that is available for the project area and the 
data type selected. The function dataBrwsO is called when a selection is made in 
the “DATASET” list. The function grayIn_Mcnu() is called to sensitize the 
“TableAdmin", and the “DataAdmin” buttons of the menu bar. When the “Dismiss” 
button is selected, dismissDatal’ressO is called to exit from the dialog. 
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Figure 2. Data Selection Dialog 


The function grayQut_Memi() is called from brwsProjectArea() to 
desensitize the “DBaseAdmin’VTableAdmin”, and the “DataAdmin” buttons of the 
menu bar. Latlon2Cursor(), and Cursor2LatLon(), are associated with trans- 
forming values between the xy coordinates of the cursor and the latitude/longitude 
values and vice versa. Latlon2Map() is called to transform the latitude/longitude 
values into a rectangle across the region in the globe. The menu-bar contains the 
following options: File, DBase Admin, Table Admin, Data Admin, and Help. 

2.2.1 Filg PttUdQ.rctiMejnu 

For the file pulldown, the options available are “Reset” and “Exit”. The 
“Reset” option calls resetMapO to erase any user selected project area and also 
erase the resulting rectangle drawn across the selected project area in the globe 
map. The “Exit” option calls quitTools() to exit from the application. 

2.2.2 DBASE Admin Pulldown Menu 

For the dbase admin pulldown, the available option is “ACL” (Access 
Control List). When the “ACL” option is selected, setupAcl() is called. This 
function calls createAclLayout() to create and display the "ACCESS CONTROL 
LIST” dialog shown in Figure 3. 




Figure 3. Access Control List Dialog 


This dialog allows the administrator to modify the access control list by 
deleting a user, adding a new user, or updating an existing user’s access 
permissions. The “Users" list in the dialog displays the list of users currently in the 
access list. The “Privileges” section contains toggle buttons for the various kinds of 
privileges. When a particular privilege is selected, getDbPrivs() is called to 
register the selection. The new user name is entered and when the “Add" button is 
selected, addNewAclUser() is called. This function first checks whether the 
name entered is a valid user or not. Then checkACLPern»issions() is called to 
check for the validity of the privileges. AclAddNewUser() is then called to add 
the new user to the access control list. 

When a user is selected from the “Users" list, brwsAclUserList() is called 
to retrieve the privilege information of the user. AclGetUserlnfoO is called for 
this purpose. Depending on the privileges, the corresponding toggle buttons are set 
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in the “Privileges” area. When a user is selected from the “Users” list and the 
“Delete” button is selected, aclCheckO is called. The function deleteAclUserO 
is then called which checks the validity of the privileges by calling check ACL 
Permissions(). .The database function delAclUserO is then called to delete the 
user from the access control list. After selecting a user from the “Users” list and 
then changing the privileges, by selecting or deselecting the corresponding toggle 
buttons, the “Update” button is selected for updating the user's access privileges. 
The functions aclCheckO and updateAclUserList() are called which checks the 
validity of the privileges by calling check ACLPermissionsO. AclUpdate 
User() is then called to update the access privileges of the user. When the “Reset” 
button is selected, InitAclO is called to initialize the ACL data structure and clear 
the dialog of any user interaction. The function getAclUserNamesO is then 
called to retrieve the list of users currently ia the access conU*ol list. When the 
“Exit” button is selected, exitToolsOption() is called to exit from the dialog. 

2.2.3 Table Admin , Pulldown,. Menu 

For the table admin pulldown, the available option is “Add Table Space”. 
When this option is selected, setupPrlmaryTbl() is called. This function first 
checks to see if the selected data type is of type “LLT” and then calls 
primary TblLayoutO to create and display the “LLT DATA TABLES” pop-up 
dialog shown in Figure 4. The PrimaryTbl data structure is then initialized by 
calling initPrimaryTbl(). The function inlfPrimaryTbl() then calls getTbl 
DataO to retrieve and display, in a list, the table name, status, and record count of 
all tables for the project area. When a list item is selected, brwsTableLlstO is 
called to register the selection. The function also checks to see if the selected item’s 
status is of type “load”. 

When the “Close” button, is selected, closePrimaryTbl() is called. The 
function checks to see if a list item is selected and then closes the table by changing 
the status from “load” to “full”. The database function changeTableO is used for 
this purpose. When the “Open” button is selected, openNewTable() is called. 
The function checks to see if the last performed user action was to close a table. 
The function newTblLayoutQ is then called to create and display the “NEW 
TABLE NAME” pop-up dialog which is used for entering a new table name or the 
suggested default name can be used. When the “Ok” button is selected, 
createNewTbl() is called. This function checks for the validity of the new table 
name ant. then creates the table by calling createTable() and exits from the 
dialog. If the “Exit” button is selected instead of “Ok”, exitNewTable() is 
activated to exit from the dialog. Selecting the “Reset” button will activate 
resetPrimaryTblO which calls InltPrlmaryTblO to initialize the PrimaryTbl 
data structure. Selecting the “Help” button will call createHelpO to create and 
display help dialogs. Selecting the “Exit” button will call exltTblLayoutO to exit 
from the “LLT DATA TABLES” dialog. 
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Figure 4. LLT Data Tables Dialog 
2.2.4 Data Admin Pulldown Menu 

For the data admin pulldown, the available options are inventory, ingest, and 
delete. When the “Inventory” option is selected from the data admin pulldown 
menu, sstupInventoryO is called. This function calls createDelDat&LayoutO 
to create and display the “INVENTORY LLT FORMAT DATA” dialog. The 
function InltDelDataStructQ initializes the delData data structure. The function 
brwsDelDataO is called to retrieve and display, in the “Versions” list, the 
available versions for the selected project area, data type, and dataset. The database 
functions get_VoI_Versions() (Volume), get_Im_Versions() (Image), and 
get_Verslons*() (LLT) are used for this purpose. When a particular version is 
selected from the “Versions” list, brwsVrsnList() is called to register the 
selection and then call, brwsDelDataO to retrieve and list from the database 
information such as id, record count, stamp time, min lon/lat, and max lon/lat for 
the selected version. The database functions getVolDelInfo() (Volume), get 
BathyDellnfoO (Bathy), getlmageDellnfoO (Image) and lin_IltDelInfo() 
(LLT) are called for this purpose. When the “Reset” button is selected, 
resetDelDataO is called to clear any user selection and initialize the delData data 
structure by calling InitDelDataStructO. When the “Exit” button is selected, 
exitToolsOption() is called to exit from the dialog. 
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When the “Ingest” option is selected, setuplngest() is called. This function 
calls createlngDataLayoutO to create and display the “INGEST LLT DATA” 
dialog. The function also calls InitlngDataStructO to initialize the ingestData 
data structure. The dialog allows the specification of the version name and the file 
name containing the data to be ingested. When the “Ingest” button is selected, 
IngestDataO is called. This function checks for the presence of the version name 
and file name. It then checks fox the user privileges by calling 
checkACLpermissions(). The program, with the appropriate parameters, 
vol_wr (Volume), or im_wr (Image), or bathy_wr (Bathy), or llt_wr (LLT) is 
executed to ingest the data into the database. The ingestData data structure is then 
initialized by calling initlngDataStructO. When the “Reset” button is selected 
all the user interactions are removed by calling InitlngDataStructO. When the 
“Exit” button is selected, exltToolsOption() is called to exit from the dialog. 

The “Delete” option is similar to that of “Inventory” except for a “Delete” 
button. When an item is selected from the dataset list, brwsDelDsetListO is 
called to register the selection and store the id of the dataset. Selecting the “Delete” 
button will call deleteDataO to delete the dataset from the database. The database 
functions delVolData_l() (Volume), delBathyDataO (Bathy), dellmage 
Data_l() (Image) and delDataO (LLT) are called for this purpose. 

2.2.5 Help 

When the “Help” button is selected, createHelpO is called to create and 
display help for the dialog from which the button was selected. 
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APPENDIX J 

INGESTING DATA INTO THE NIDAS DATABASE 


Data ingestion is independent of NIDAS. A database administrators tool is 
provided for ingesting data into the database. This tool takes a data file and 
ingest the data into the database. The data file can be in one of three data types: 
Bathymetry, LLT (MOODS), Image, or Volume (3-D Grid). The format 
abbreviations used are as follows: F is Float, I is Integer, and A is ASCII. 

BATHYMETRY 

Bathymetry is in Charter format with the following format: 


Parameter 

MW.T11 

Longitude of the West Side 

F 


F 

Latitude of South Side 


Latitude of North Side 

f 


__ E 


I 


I 



(Columns*Rows in Row Major Order) 

F 


LLT 

LLT is in Master format which is a binary file with the following format: 
File Header (First record in Master filet 


JIHHNNMl 



Range 

File Type 

A1 


T - Temperature 
S - Salinity 
V - Sound Speed 
B - Both Temperature 
and Salinitv 

Dataset Description 

A60 




J-l 







I ill >T 3 * 4 1 i I i 1 h T , JfTj Ml’l'l i W » PT 

• • kBlinj"HMB’i3£TTVIMI 


Flags 


Flag [1] 

Temperature Edit Flag 


Flag[2] 

Salinity Edit Flag 


Hag[3] 

Gridded Database used 


iOT iWA 


Flag[4] 

Artificial or Converted 
Profile 


FlagfS] 

Number of Extended 


1 1 »l<iK9 (OKI*! • fsJ«R 


Flag[6] 

Number of Extended Depths 
to Bottom 


Each of the $ flags are 


P Ii75 frW'i 


0 m Not Yet Examined 

1 » Good Profile 

2 » Coarse Resolution 

3 « Inconsistent 

4 - Duplicate (Keep) 

5 - Duplicate (Reject) 

6 * Suspect 

7 - Needs Repair 

8 « Wrong Location 




0 » Not Yet Examined 

1 - Good Profile 

2 - Coarse Resolution 

3 - Inconsistent 

4 » Duplicate (Keep) 

5 * Duplicate (Reject) 

6 - Suspect 

7 - Needs Repair 

8 « Wrong Location 




0 - True Random 
(MOODS or other) 

1 - Gridded to Random 
8 - Artificial (General) 




-2 









Flag[7] 
Temperature 
Only valid when File 




Flag[8] 

Salinity 

Only valid when File 


1 « No Temperature 
Values in Profile 
(All Temperature Values 


EMI 


1 ■* No Salinity Values 
in Profile 

(All Temperature Values 
- -99) 


Province Flag (Groups 
profiles into Geographical 

Provinces^ 


Pattern Flag (Used in 


'mu' mi ii — 


Water Depth at Profile 
Location in Original 




Water Depth at Profile 
Location from Bathymetry 


F 

-99 

F 

-99 




Source/Instrument Code 


Number of Data Cycles 
(Depths) in Original 




Number of Cycles added to 
Profile when Artificially 




Cruise Number 


The first two integers are 
the instrument code and 
the last four integers tire 


II! i WfcM* \ R 


Flag[5] + Flag[6] 
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Profile Rfecard (Date Esssaah 


If File Type - ’T’ 

If File Type -’S’ 

If File Type -’V* 

If File Type - ’B’ 

The data based on File Type is 
Added Cycles” times. 


Depth and Temperature 

Depth and Salinity 

Depth and Sound Speed 

Depth, Temperature, and Salinity 

repeated “Number of Data Cycles” + “Number of 


IMAGE 


Image is made up of AVHRR LAC (Local Area Coverage) data and are 
available in “mes” files. The format of the “mes” file is as follows: 


Header Record (First Record in Image fils) 


If 4 i i i va ilTMHHHHHBH 


rjwirri 

FiJJTTffn 

Range 

Format/Generating 
Software ID 

1-8 

A8 


“SEAS v#r 
## » Version number 
_fLe^_40_is 4.0) 

Image Classification 

9 

A1 

S 

U « Unclassified 
R « Restricted 
C = Confidential 
S - Secret 
N « Secret Nofom 
T « Top SecreL 

Total Number of 256-byte 
Header Blocks 

10 

11 

1 

1-9 

(1 + RGB Records 
_ + Optional Records') 

Date Time Group 

11-24 

A14 


ddhhmmZMMMyy 
dd - Day (0-31) 
hh <* Hours (0-23) 
mm =* Minutes (0-59) 
Z « Zulu 
MMM *■ Month 
(JAN-DEC) 
yy - Year (0-99) 

Data Compression Code 

25-26 

A2 

0 

0 - No Compression 
DC - Discrete Cosine 
Transformation 
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Projection Code 

27 

A1 

Image Type Code 

28 

A1 




Number of Pixels per 33-36 


JwLUuilfli . .... 

WMSW 


iatijMi|Mi3n 


I3B5KW 


Temperature Reference 47-52 

for Minimum Pixel Value 


Temperature Reference 53-58 
for Maximum Pixel Value 


Temperature Reference 59 


Longitude Reference 






Image Row of Ref 
Point 2 




47-52 

F6.2 

53-58 

F6.2 

59 

A1 

60-69 

F10.5 



i5 


15 


FI 0.5 


108-112 

15 

113-117 

15 


M » Mercator 
P - Polar Stereographies 
S - Polar Stereographies* 
R - Rectangular 
Coordinates 
G - Gridded Data 
N - No Projection Used 

* 90 Degree Tangent 

** * ■■ 





I - Infrared 
V - Visual 
P-PCX 




1 -480 



0.0 999 - No Cross Reference 


0.0 999 - No Cross Reference 


C - Degrees Celsius 
F - Degrees Fahrenheit 
Blank * No Temperature 


IH3fcJW»hM 


•180W - 180E 






-180W- 180E 




2 - “Number of Pixels 
er Column” 
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WWTiTrni oM'iii'ik- 1 ! ill »I3 m l \ 

Range 


89-98 

FI 0-5 


-180W- 180E 






Image Column of 
Reference Point 3 

137-141 

15 


“Number of Pixels per 
Row” 


142-146 

15 


“Image Row of Reference 
Point 2” 

File Originator 

147 

11 

1 

1 - NAVO 

2-FNOC 

Destination 

148 

11 

1 


Image Source Identifica- 
tion Comment 

149-188 

A40 



EGA Palette Flag 

189 

11 

0 

0 - EGA Palette Not 
Included 

EGA Color Palette. _ 

190-205 

I16_ 


_0-15 

RGB Palette Fiag 

206 

11 

0 

1 

0 - RGB Palette Not Included 

1 RGB Palette Included 

2 «* 256x3 (R,G,B) Palette* 

3 - 64x3 (R,G,B) Palette * 
♦Palette follows Header 

Record 

T I Tlf'T 1 — 

msm 

m 


_Q - 61 _ _ 

Undefined 

255-256 

A2 




J&GB1 JEakttfe Kecoidfi 

The RGB records containing the red, green, and blue color palettes are for 
the monitors operating in the 256-color mode. These records exist when the RGB 
palette flag is set to 2 or 3 in the header record. The 256 RGB palette will occupy 
three records: 256 red values, 256 green values, and 256 blue values (in that 
order). The 64 RGB palette will occupy only one record with three sections, each 
containing 64 RGB values. The remaining 64 values are undefined. The number 
of records in this section is included in the total number listed in the header record. 

Optimal . TeaL&fiCflEds 

Additional text records are 256 bytes each in length. These records contain 
descriptive text concerning the image. The number of records in this section is in 
the totai number list in the header record. 
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The image pixel data follows the header and text records. It is a series of 
8-bit binary integer values that can range from 0 to 255. Each byte represents an 
image pixel. The data structure is based on the number of pixels per row and the 
number of pixels per column listed in the header record. The data is organized by 
row such that byte 1 is the first pixel of the first row and column. The second byte 
is the pixel at row 1, column 2 and so on. 

VOLUME 

Volume is a 3-D grid designed for ocean climatologies with a single 
parameter (temperature OR salinity OR sound speed OR whatever). 3-D gridded 
model output can also use this format by interpreting the date differently. The 
format is as follows: 




riarTTitrmTiniQiini 


Inrrrmrn 


Grid Type 


Ocean Parameter 





Number of Meaningless 

Pgtte-aiJlifcJiflttgm 

Classification of Grid 



Extra Variable for Future Use F 



T « Temperature 
S - Salinity 
V - Sound Speed 
C - Conductivity 


IWDV3 TfJTC 



0 - Public Domain 

1 - Restricted 

2 - Confidential 



* Date or Season includes 12 integers, one integer per month. A 0 means that the 
grid does not include that month. A 1 means that the grid includes that whole 
month. A 2 means that the grid includes only the last two weeks of that month. 
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A 3 means that the grid includes only the first two weeks of that month. For 
example, 000000002130 - last two weeks of September through the first 
two weeks of November. If the first integer is a 9, then the grid is associated 
with a specific data and time. This is usually the case for gridded model output. 
In this case, the 12 integers are defined as follows: 

[1] - 9 (Identifying and specific date and time) 

[2] -0 (Undefined) 

13) « Month 

14) - Day 

[5] - Year (4 digits) 

[6] - Hour/Minutes (24 hour clock, 4 digits) 

[7-12] - 0 (Undefined) 


iTrffnHpITMHoT* HikhTTiT' » c/TTTffWMB 3n 


longitude of West Side 

F 

Longitude of East Side 

F 

Latitude of South Side 

F 

Latitude of North Side 

F 

Grid Resolution in Minutes 

F 

Number of Columns (East-West) 

I 

Number of Rows (North-South) 

I 


Date or Season 
Same as in Header 1. 




Number of Depths in Profile to the 


l(vaB».i B ) !W <iS m«SlSiiroCTi 


Data (Specified in Header Record 1) 

Fx 

There are “Number of Depths in Profile 
to the bottom of Grid’’ number of these. 
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